Skip to main content
OpenLight returns structured JSON errors for authentication, authorization, validation, not found, conflict, rate limit, and server failures. 
{
  "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.