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

# API errors

Common error responses and how to handle them.

API errors return JSON with an `error` field.

```json
{
  "error": "Unauthorized"
}
```

## Common statuses

| Status | Meaning | Fix |
| --- | --- | --- |
| `400` | The request body or parameter is invalid. | Validate against the OpenAPI spec. |
| `401` | Missing or invalid auth. | Check API key, session, or webhook secret. |
| `403` | The account or plan cannot perform the action. | Check plan limits and project access. |
| `404` | Resource not found. | Confirm the ID and account ownership. |
| `429` | Quota or rate limit reached. | Wait, reduce retries, or add credits. |
| `5xx` | Server-side failure. | Retry with backoff and keep the original request ID if available. |

## Retry guidance

Retry `429` and `5xx` responses with exponential backoff. Do not retry validation errors without changing the request.