Skip to main content
Errors return a JSON body with either an error_code field (audio, capacity, and inference errors) or a detail field (auth and rate-limit errors).

​
Retry guidance

  • 429 and 503 are transient — retry after the Retry-After header (or a short backoff when absent).
  • 400, 413, and 415 indicate a problem with the request itself — fix the audio or config before retrying. See Audio requirements for the constraints.
  • 500 and 504 are safe to retry once; persistent failures warrant a support ticket.

​
Need help?

If you get stuck, contact our support team at support@assemblyai.com or create a support ticket. Include the session_id from the response (or the failing request’s timestamp and endpoint if no response was returned) to help us look up your request.