Background Audio
Check conversion status
Conversion runs after finalize returns, so poll this until status leaves UPLOADING.
UPLOADING— still converting.READY— usable; attach it to an agent.FAILED— seeerror_message. A file that is decodable but longer than 5 minutes lands here rather than converting.
A 5 MB upload converts in seconds. Polls count against the 60 requests/minute partner limit, which is shared across the whole /api/v2 surface — polling once a second will exhaust it and start returning 429 on your call starts. Poll every 2-3 seconds, and back off on 429 using Retry-After.
Give up after 60 seconds: an asset still UPLOADING at that point is not going to finish, and should be surfaced as a failed upload and re-uploaded rather than polled indefinitely.
GET
Check conversion status