Get Audio Playback Url Route

GET 
/v2/audios/{audio_id}/playback-url

Get a short-lived URL for playing back an audio.

The returned url streams the stored audio inline in a browser or media player. It is short-lived: request a new one when expires_at passes or when a request made with it is refused, and do not store or share it. The audio's url and media_source_url fields are references to the stored media, not guaranteed to be readable; this endpoint is how to play it.

Access Control: the same as the audio details. The owner and admins can always get a playback URL. While an audio (or the video it belongs to) is shared, or is a sample, anyone can, so sharing lets anyone with its link play it back.

Errors:

• 401: not authorized to access this audio
• 404: audio not found
• 409 media_not_stored: the audio has no stored copy to play (for example, an audio submitted by URL whose copy is not ready yet)
• 503 media_storage_unavailable: temporarily unavailable; try again shortly

Request

Responses

200

Successful Response

401

Missing, malformed or rejected credentials — no X-API-Key / Authorization: Bearer <jwt>, an expired token, or a caller that lacks the role the route requires. Note that this API answers authorization failures with 401 as well as 403 (see the 403 entry where a route declares both).

404

No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records.

409

media_not_stored: there is no stored copy to play yet.

422

Validation Error

503

media_storage_unavailable: try again shortly.