Livepush Developers

Videos

List video folders

GET https://octopus.livepush.io/streams/{stream_id}/videos/resource_groups

Base URL https://octopus.livepush.io — Core Streams & Media APIs

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.

Authorization

Send a valid access token in the Authorization header.

  • bearerAuth — Bearer token (JWT)
headers.txt 
Authorization: Bearer YOUR_API_TOKEN

Try it

GET https://octopus.livepush.io/streams/{stream_id}/videos/resource_groups — This call only reads data.

Parameters

Path parameters

  • stream_id string required
    Unique identifier of the stream.
    example: st_xxxxxxxxxxxxx

Code samples

request.sh 
curl -X GET 'https://octopus.livepush.io/streams/st_xxxxxxxxxxxxx/videos/resource_groups' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://octopus.livepush.io/streams/st_xxxxxxxxxxxxx/videos/resource_groups', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
  },
});

if (!response.ok) {
  throw new Error(`Livepush API error ${response.status}`);
}

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN',
}

response = requests.get('https://octopus.livepush.io/streams/st_xxxxxxxxxxxxx/videos/resource_groups', headers=headers, timeout=30)
response.raise_for_status()
data = response.json()

Responses

List video folders.

application/json

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.
    streamvideo
  • name string
    Display name of the folder.
  • user string
    Owning account.
  • Key string
  • createdAt string<date-time>
  • isDisabled boolean
Example 200 response response.json 
[
  {
    "id": "grp_xxxxxxxxxxxx",
    "type": "video",
    "name": "Sunday services",
    "user": "string",
    "Key": "string",
    "createdAt": "2026-01-31T09:00:00.000Z",
    "isDisabled": false
  }
]

No response body.

Not found for this account.