DocsError codes

voice_format

The uploaded voice recording is not in a format the platform takes.

On this page
422HTTP 422 · Voice Format

What it means#

The uploaded voice recording is not in a format the platform takes.

Retry after fixing

Retrying unchanged will not help. Correct the cause, then send it again.

What causes it#

  • A video file, or an audio format other than MP3, WAV, M4A, OGG or WebM.

How to fix it#

  • Record in the studio, or upload one of those formats.

What the response looks like#

422 application/problem+json
{
  "error": {
    "code": "voice_format",
    "message": "The uploaded voice recording is not in a format the platform takes",
    "request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
  },
  "type": "https://integrable.cloud/docs/errors/voice_format",
  "title": "Voice Format",
  "status": 422,
  "detail": "The uploaded voice recording is not in a format the platform takes",
  "instance": "/api/agents/01a0652b-3713-7ea1-a6c9-2e895389ec34"
}

Branch on error.code, not on the message — the code is stable, the sentence is not. Log request_id either way.

Still stuck#

Quote the request_id from the response — hello@integrable.cloud. It is what lets us find the exact request. The full list of codes is at Error codes, and the conventions every endpoint shares are in Retries, versioning and limits.

Something unclear or missing? Tell us and we’ll fix it.