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

# Errors

> Handle OpenLight Public API error responses

OpenLight returns structured JSON errors for authentication, authorization, validation, not found, conflict, rate limit, and server failures.

```json theme={null}
{
  "error": {
    "code": "unauthorized",
    "message": "Authentication is required.",
    "request_id": "req_01HR8Y4Q9M5K2X7J3A6B8C9D0E"
  }
}
```

Common error codes:

* `unauthorized`: The request is missing a valid API token.
* `forbidden`: The token does not have permission to access the resource.
* `not_found`: The resource does not exist or is not visible to the token owner.
* `validation_error`: The request payload or query parameters are invalid.
* `conflict`: The request conflicts with the current resource state.
* `rate_limited`: Too many requests were sent in a short period.
* `internal_error`: The API could not complete the request.

Use the HTTP status code for control flow and the error code for product-specific handling. Include the `request_id` when contacting OpenLight support.