List Error Codes | sync. labs

[
  {
    "code": "generation_input_video_inaccessible",
    "message": "The video input could not be fetched.",
    "suggestion": "Check that the video URL is publicly reachable, or upload the file via POST /v2/assets/upload and reference it by assetId."
  },
  {
    "code": "generation_plan_duration_exceeded",
    "message": "The output duration exceeds your plan limit.",
    "suggestion": "Use shorter media or upgrade your plan."
  },
  {
    "code": "project_not_found",
    "message": "The projectId was not found in your organization.",
    "suggestion": "Omit projectId, or use a project id that belongs to your organization (project ids from other organizations or deleted projects are not valid)."
  },
  {
    "code": "voice_not_found",
    "message": "No voice was found with that id in your organization.",
    "suggestion": "List valid voice ids via GET /v2/voices. Cloned voice ids are UUIDs scoped to the organization that created them."
  },
  {
    "code": "elevenlabs_service_unavailable",
    "message": "Voice service is temporarily unavailable.",
    "suggestion": "Retry the request with backoff. If it keeps failing, contact support with the request id."
  }
]

Returns the full catalog of machine-readable error codes — each with a human-readable message and a suggested fix. It covers generation failures plus the coded errors returned by the assets, voices, and TTS endpoints (e.g. project_not_found, voice_not_found, asset_forbidden). This endpoint is unauthenticated. Pair it with the errorCode field returned on a failed generation or on a coded 4xx/5xx response so an agent can look up what went wrong and how to correct it without hard-coding error strings.

Response

Error catalog retrieved successfully

codestring

The stable error code (e.g. generation_input_video_inaccessible).

messagestring

A human-readable description of the error.

suggestionstring

A suggested fix an agent can act on.

Errors

500

Internal Server Error