> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machines.cash/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors & Retries

> Deterministic error codes and retry guidance for agents and services.

Common error codes:

* <code>invalid\_request</code> (400)
* <code>unauthorized</code> (401)
* <code>forbidden</code> (403)
* <code>not\_found</code> (404)
* <code>conflict</code> (409)
* <code>service\_unavailable</code> (503)

<Note>All responses use a consistent envelope by default: `{ ok, data, summary, errors[], next }`. Set <code>X-Open-Responses: 1</code> to receive Open Responses-style outputs.</Note>

## Open Responses error shape (optional)

When <code>X-Open-Responses: 1</code> is set, errors return the Open Responses error object:

```json theme={null}
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "param": "walletAddress",
    "message": "walletAddress required to create a new mapping"
  }
}
```