OCT-103 Gumlet outreach
POST/video/live/assets/update

Update a live streaming asset

Updates an existing live streaming asset. Supply live_asset_id to identify the asset, and include title or start_at to change those values. A 200 response returns the updated asset details.

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

3 body fields

Live asset fields to update. live_asset_id is required.

live_asset_idstringrequired

Gumlet live video asset id.

start_atstringoptional

The updated start time in date-time format.

titlestringoptional

Your live stream asset title

5 status codes
200Returns the live asset details, including its identifier, status, stream information, playback details, 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

  • parameter_missing

    One or more required values are missing.

errorobjectrequired
401Returned when the request is unauthorized.

One documented failure

  • source_not_found

    Could not find any video source with specified source 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
404Returned when the live asset is not found.

One documented failure

  • live_asset_not_found

    Live Video Asset not found.

errorobjectrequired

Error handling

A 400 is returned for a bad request, a 401 for an unauthorized request, a 403 for an unpaid account or insufficient role permissions, and a 404 when the asset is not found. live_asset_id is required, and start_at must use date-time format when supplied.