# List video folders
`GET https://octopus.livepush.io/streams/{stream_id}/videos/resource_groups`
Returns the video folders defined for the account.

Video folders appear as `resource_group` in the URL and as `resourceGroup` on the video object — the original internal name, kept for compatibility.

Requires a token with the `streams.videos.write` scope.
- **Tag:** Videos
- **Operation ID:** `listVideoFolders`
- **Authentication:** Bearer token required
- **Docs:** https://developers.livepush.io/videos/list-video-folders/

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `stream_id` | string | yes | Unique identifier of the stream. |


### Example request

```bash
curl -X GET 'https://octopus.livepush.io/streams/st_xxxxxxxxxxxxx/videos/resource_groups' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
```


### Responses


#### 200 — List video folders.

- _array of VideoFolder_
- `id` (string)
- `type` (string) — The kind of resource the folder holds. Video folders are always video; the stream variant exists in the same collection but is not exposed here.
- `name` (string) — Display name of the folder.
- `user` (string) — Owning account.
- `Key` (string)
- `createdAt` (string<date-time>)
- `isDisabled` (boolean)


```json
[
  {
    "id": "grp_xxxxxxxxxxxx",
    "type": "video",
    "name": "Sunday services",
    "user": "string",
    "Key": "string",
    "createdAt": "2026-01-31T09:00:00.000Z",
    "isDisabled": false
  }
]
```


#### 401 — Response


#### 404 — Not found for this account.