Error Handling

UNAUTHORIZED: Invalid or missing authentication
FORBIDDEN: Insufficient permissions
NOT_FOUND: Resource not found
VALIDATION_ERROR: Request validation failed
RATE_LIMIT_EXCEEDED: Rate limit exceeded

The API uses standard HTTP status codes and returns error details in the response body.

Error Response Format

{
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": {
    "field": "Additional error details"
  }
}

Scope: Tenant-scoped; requires authenticated org context
Availability: Not available in SuperAdmin

Error responses include details about what went wrong. Check the error code and message for guidance on resolving issues.