> For the complete documentation index, see [llms.txt](https://docs.guayaba.run/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guayaba.run/documentation/api-reference/error-responses.md).

# Error Responses

Errors follow this structure:

```json
{ "error": "ErrorCategory", "message": "Human-readable explanation" }
```

| Code  | Meaning                                                                      |
| ----- | ---------------------------------------------------------------------------- |
| `401` | Missing, invalid, or revoked API key                                         |
| `402` | Insufficient credits                                                         |
| `403` | No active subscription / key lacks scope / wrong agent / master key required |
| `404` | Agent or resource not found                                                  |
| `422` | Validation errors                                                            |
| `502` | Proxy request to agent container failed                                      |
| `503` | Agent container not running                                                  |
