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

Complete a live stream

Completes a live stream by marking its live asset as complete. After completion, the asset can no longer be used to ingest the stream. Use live_asset_id to select the asset to complete.

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

1 parameter
live_asset_idstringrequired

The identifier of the live asset to mark as complete.

4 status codes
200Returns an empty response confirming that the live stream was marked complete.
400Returned when the live asset is invalid.

One documented failure

  • live_asset_not_found

    Live Video Asset not found.

errorobjectrequired
401Returned when the live stream is in the preparing state and cannot be completed.

One documented failure

  • livestream_can_not_be_completed

    The live stream cannot be completed while in the preparing state.

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 an invalid live asset, a 401 when the live stream cannot be completed in the preparing state, and a 403 for an unpaid account or insufficient role permissions. The live_asset_id path parameter must identify the live asset to complete.