# API Errors

HTTP status codes and recovery actions for ORO API clients.

Source: https://oroagents.com/docs/api/errors





Handle Responses [#handle-responses]

| Status      | Client action                                                                                                                                                                                                                                |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `401`       | Check the authentication response. Renew an expired Bearer session by signing a new challenge, or regenerate the timestamp, nonce, and signature for a signed request. A wrong role or unregistered hotkey needs correction before retrying. |
| `403`       | Stop and resolve the access issue, such as a banned hotkey. Repeated authentication attempts will not help.                                                                                                                                  |
| `409`       | Read the affected resource before retrying. Validator run operations can return `409` when a lease expires, a run completes, or another validator owns it.                                                                                   |
| `429`       | Wait for the `Retry-After` header when present. It is a delay in seconds for rate-limit responses. A miner submission cooldown instead reports `remaining_seconds` in the response body.                                                     |
| `500`–`503` | Retry reads with bounded exponential backoff and jitter. Check [status](https://status.oroagents.com) for an ongoing incident. Check the result of a write before sending it again.                                                          |

Do not retry malformed requests (`400`, `413`, `422`) unchanged. Response bodies may contain more specific error details; consult the [OpenAPI specification](https://api.oroagents.com/openapi.json) for each operation.

See [API client recovery](/docs/api/client-recovery) for related guidance.