Errors

The Alium API uses standard HTTP status codes to indicate success or failure.

Error responses

Status	Description
401 Unauthorized	Missing or invalid API key
403 Forbidden	API access or required feature not enabled for your account
404 Not Found	Record not found or not accessible to your team
422 Unprocessable Entity	Invalid product or use_case parameter value
429 Too Many Requests	Rate limit exceeded (see Rate Limits)

Error format

Error responses include a JSON body with an error field:

{
  "error": "Unauthorized"
}

Rate limit errors also include a retry_after field:

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

Data access

All API responses are scoped to transcripts provisioned to your team. Attempting to access a transcript outside your provisioning returns 404 Not Found (not 403), so that the existence of other transcripts is not disclosed.