Livepush Developers

Videos

Move a video into a folder

PUT https://octopus.livepush.io/streams/{stream_id}/videos/{video_id}/set_group/{group_id}

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

Files the video under a video folder. A video belongs to at most one folder, so this moves it rather than adding a second membership.

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

PUT https://octopus.livepush.io/streams/{stream_id}/videos/{video_id}/set_group/{group_id} — This call changes live data on your account.

Parameters

Path parameters

  • stream_id string required
    Stream identifier. These handlers resolve the video by video_id scoped to the authenticated account and never read this value, which is why the dashboard passes the literal me. Any value routes correctly.
    example: st_xxxxxxxxxxxxx
  • video_id string required
    Unique identifier of the video.
    example: vd_xxxxxxxxxxxx
  • group_id string required
    Unique identifier of the video folder.
    example: grp_xxxxxxxxxxxx

Code samples

request.sh 
curl -X PUT 'https://octopus.livepush.io/streams/me/videos/vd_xxxxxxxxxxxx/set_group/grp_xxxxxxxxxxxx' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://octopus.livepush.io/streams/me/videos/vd_xxxxxxxxxxxx/set_group/grp_xxxxxxxxxxxx', {
  method: 'PUT',
  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.put('https://octopus.livepush.io/streams/me/videos/vd_xxxxxxxxxxxx/set_group/grp_xxxxxxxxxxxx', headers=headers, timeout=30)
response.raise_for_status()
data = response.json()

Responses

Success.

application/json

  • success boolean
Example 200 response response.json 
{
  "success": true
}

No response body.

Not found for this account.