OCT-103 Gumlet outreach
POST/video/live/assets/thumbnail/upload

Generate live stream thumbnail upload URLs

Generates presigned upload URLs for thumbnails associated with a live streaming asset. Supply live_asset_id and the thumbnail states to upload; supported states are preparing, disconnected, and end. Use the returned URLs to upload the corresponding thumbnails.

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

2 body fields

Live asset identifier and thumbnail states for which to generate presigned upload URLs. Both fields are required.

live_asset_idstringrequired

Gumlet live video asset id.

statusesarray<string>required

Thumbnail states to upload. You can send an array or a comma-separated string.

6 status codes
200Returns a message and presigned upload URLs for the requested thumbnail states.
messagestringoptional
presigned_upload_urlsobjectoptional
400Returned when the request is invalid.

One documented failure

  • invalid_parameter

    Provide at least one valid status in "statuses". Allowed: preparing, disconnected, end.

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 request is forbidden.

One documented failure

  • live_asset_not_found

    Live Video Asset not found.

errorobjectoptional
404Returned when the requested resource is not found.

One documented failure

  • not_found

    Live Video Asset not found.

errorobjectrequired
500Returned when an internal server error occurs.

One documented failure

  • internal_server_error

    We have encountered some server error. We have been notified and will fix it soon.

errorobjectrequired

Error handling

A 400 is returned for a bad request, a 401 when the API key or bearer token is missing or invalid, a 403 for a forbidden request, a 404 when the requested resource is not found, and a 500 for an internal server error. live_asset_id and statuses are required; each status must be preparing, disconnected, or end.