Reference
Errors
One error shape everywhere.
shape
{ "error": "human-readable message", "code": "MACHINE_CODE", "field_errors": { "field": "why" } }
// meta.requestId is on every response; quote it when reporting a problem| Status | Code | Meaning |
|---|---|---|
| 400 | MALFORMED_JSON | body was not valid JSON |
| 401 | UNAUTHORIZED · INVALID_API_KEY · INVALID_SESSION | missing, revoked or unverifiable credentials |
| 402 | INSUFFICIENT_CREDITS | out of credits and free messages (hosted runtime, marketplace) |
| 403 | FORBIDDEN · ADMIN_REQUIRED · PRIVY_DISABLED | not allowed for this caller |
| 404 | not found, or not visible to you | |
| 422 | CONFIRMATION_REQUIRED | a money-moving call lacked its confirm_* flag |
| 422 | validation failed; see field_errors | |
| 429 | tier quota exceeded | |
| 502 | PROVIDER_ERROR | the model provider returned an error |
| 503 | RUNTIME_DISABLED | hosted runtime is off on this deployment |