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

Complete an audio upload

Completes an audio upload by attaching uploaded audio tracks to an existing video asset. Call this after you PUT each audio file to the upload URL returned by the add-audio operation. Include each track's language and upload status in upload_responses when you provide that field.

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

1 parameter · 1 body field
asset_IDstringrequired

The unique identifier of the existing video asset receiving the uploaded audio tracks.

Optional upload status details for the audio tracks being attached to the asset.

upload_responsesarray<object>optional

A list of audio upload results, each containing a language code and a boolean indicating whether that track uploaded successfully.

5 status codes
200Returns an empty JSON object confirming that the audio upload completion request was processed.
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 has insufficient 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 indicates an invalid request; a 401 indicates a missing or invalid API key or bearer token. A 403 indicates an unpaid account or insufficient role permissions, and a 500 indicates an internal server error. The asset_ID path parameter identifies the asset, and upload_responses can report each track's language and upload status.