Skip to main content
A call that fails answers a 4xx or 5xx status and this body:
Every code is in UPPER_SNAKE case and means the same on every operation. New codes may be added; a code is never renamed within /v2. Treat a code you do not know by its status: retry a 5xx or a 429 later, fix the request on another 4xx.

Status codes

Codes

Requests

Credentials and access

Plan, credits and limits

Records and state

Connected tools

Failures

These are Clustr’s or a service’s failures, not the request’s. Retry with backoff.

A streamed assistant turn

A turn streamed as Server-Sent Events (POST /v2/assistant/messages with stream: true) answers 200 before it runs. A failure after that is an error event carrying the same code and a sentence in error, and ends the stream.