Error codes
Complete reference of retryable and non-retryable error codes.
Error codes
Retryable errors
These errors may succeed on retry. Apply exponential backoff.
| Error | Description |
|---|---|
TIMEOUT | Request timed out |
CONNECTION_FAILED | Could not connect to the app instance |
APP_CRASHED | App instance crashed during execution |
RATE_LIMITED | App hit an external rate limit |
NOT_READY | Instance is not yet ready to accept requests |
SPAWN_FAILED | Failed to spawn a new instance |
CONTROLLER_AT_CAPACITY | Controller is at capacity (see Backpressure) |
Non-retryable errors
These errors will not succeed on retry. Fix the underlying issue before retrying.
| Error | Description |
|---|---|
TOOL_NOT_FOUND | The requested tool does not exist |
INVALID_ARGUMENTS | Tool arguments failed validation |
UNAUTHORIZED | Authentication required but not provided |
FORBIDDEN | Authenticated but not authorized |
PERMISSION_DENIED | Insufficient permissions |
INTERNAL_ERROR | Unrecoverable internal error |
VERSION_UNSUPPORTED | App version not supported |
SESSION_NOT_FOUND | Session does not exist or expired |
INSTALLATION_UNKNOWN | Installation ID not recognized |
Related
- Backpressure — capacity limits
- Controller configuration — tuning limits