Skip to main content
Errors follow the compatibility surface used by the request: OpenAI-shaped for Chat Completions and Responses, and Anthropic-shaped for Messages.
StatusMeaningRecommended action
400Invalid request or invalid provider key configurationCorrect the request or provider-key configuration.
401Missing or invalid Tokenless API keyVerify the credential and authentication header.
402No available account creditAdd credit in the dashboard.
429Rate limitedRetry with exponential backoff and jitter.
503No upstream candidate currently availableRetry with exponential backoff and jitter.
529Temporarily overloadedRespect Retry-After, then retry.
Do not automatically retry malformed requests, authentication failures, or invalid provider-key errors. For temporary failures, cap the number of retries and include jitter to avoid synchronized retry spikes.

​
Correlation

Capture the X-Request-Id response header whenever present. It is the most useful identifier when investigating a request with Tokenless support.