Errors

All error responses follow a consistent JSON format:

1
{
2
  "error": "not_found",
3
  "detail": "Session not found.",
4
  "status_code": 404
5
}

Status codes

Common error codes

Field-level validation (422)

Request bodies for sessions, cases, identities, and screening enforce strict field bounds. Violations return 422 Validation Error with a detail array naming each offending field. Common triggers:

• String fields exceeding their maxLength (typically 100, 500, or 5000 characters depending on the field).
• Lists exceeding their maxItems (typically 50 tags or 100 items).
• The metadata object exceeding 16 KB serialized.

Fix the request body before retrying — these errors are not transient.

Retry guidance

Related

• Authentication — 401 and 403 error details
• Rate Limiting — 429 response handling and quotas
• Idempotency — 422 idempotency mismatch errors