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

Start a live stream

Starts a live stream for a specified live asset. Use live_asset_id to select the asset whose stream you want to start. A 200 response confirms the request.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
live_asset_idstringrequired

The identifier of the live asset whose stream to start.

4 status codes
200Returns an empty response confirming the request to start the live stream.
400Returned when the request is invalid.

One documented failure

  • unable_to_start_live_asset

    Could not start live asset.

errorobjectrequired
401Returned when the API key or bearer token is missing or invalid.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
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 when the API key or bearer token is missing or invalid, and a 403 for an unpaid account or insufficient role permissions. The live_asset_id path parameter must identify the asset whose stream you want to start.