OCT-103 Gumlet outreach
GET/video/live/assets/{live_asset_id}

Get live asset details

Retrieves the details of a previously created live video asset. Use live_asset_id to identify the asset whose status and stream details you need.

1 parameter
live_asset_idstringrequired

The identifier of the previously created live asset to retrieve.

4 status codes
200Returns the live asset details, including its identifier, source, status, stream key, stream URL, playback details, thumbnail URLs, and timestamps.
created_atintegeroptional
Default:0
inputobjectoptional
live_asset_idstringoptional
live_video_source_idstringoptional
outputobjectoptional
statusstringoptional
stream_keystringoptional
stream_urlstringoptional
thumbnailobjectoptional
updated_atintegeroptional
Default:0
vod_asset_idstringoptional
400Returned when the request is invalid.

One documented failure

  • live_asset_not_found

    Live Video Asset not found.

errorobjectrequired
401Returned when the request is unauthorized.

One documented failure

  • live_asset_not_found

    Could not find any live video asset with specified asset_id.

errorobjectoptional
403Returned when the account is unpaid or the authenticated user lacks the required role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired

Error handling

A 400 is returned for a bad request, a 401 for an unauthorized request, and a 403 for an unpaid account or insufficient role permissions. The live_asset_id path parameter must identify a previously created live asset.