OCT-103 Gumlet outreach
POST/video/assets/{asset_ID}/subtitle/upload/event

Submit subtitle upload results

Submits the results of subtitle file uploads to start adding the subtitles to a video asset. Call this operation after uploading the files to the signed URLs returned by the subtitle upload operation. Include each language code and whether its file upload succeeded in upload_responses.

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

1 parameter · 1 body field
asset_IDstringrequired

The identifier of the video asset receiving the uploaded subtitles.

The outcomes of subtitle file uploads, grouped by language.

upload_responsesarray<object>optional

Array of objects of uploaded languages

5 status codes
200Returns an empty object after submitting the subtitle upload results.
400Returned when the request is invalid.

One documented failure

  • no_additional_track

    No track request exists. Please upload a track first.

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
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 an unpaid account or insufficient role permissions, and a 500 for an internal server error. The asset_ID path parameter must identify the asset; report each uploaded language and its upload outcome in upload_responses.