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

# Error

> The error object returned when a request fails.

When a request fails, the API returns a JSON error object with a machine-readable error type and a human-readable message. See [Error handling](/api-reference/errors) for a full list of error codes and troubleshooting guidance.

## Fields

<ParamField path="error" type="string" required>
  Machine-readable error type (e.g. `Unauthorized`, `NotFound`,
  `ValidationError`, `TooManyRequests`).
</ParamField>

<ParamField path="message" type="string" required>
  Human-readable description of what went wrong.
</ParamField>

## Examples

<CodeGroup>
  ```json 401 Unauthorized theme={null}
  {
    "error": "Unauthorized",
    "message": "Invalid API token"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "NotFound",
    "message": "Resource not found"
  }
  ```

  ```json 400 Validation Error theme={null}
  {
    "error": "ValidationError",
    "message": "Invalid request body"
  }
  ```

  ```json 429 Rate Limited theme={null}
  {
    "error": "TooManyRequests",
    "message": "Rate limit exceeded. Please retry after 60 seconds."
  }
  ```
</CodeGroup>