Skip to main content

Errors

Errors are returned with standard HTTP status codes and a JSON payload.

Common formats​

{
  "detail": "Task not found"
}

Rate limit responses return a structured body:

{
  "error": "rate_limited",
  "detail": "Rate limit exceeded",
  "retry_after": 12.5
}

Typical status codes​

  • 400 Invalid input or malformed JSON
  • 401 Missing or invalid token
  • 403 Token missing required scope
  • 404 Resource not found
  • 409 Conflict (for example, outside working hours)
  • 413 Payload too large
  • 422 Validation error
  • 429 Rate limited
  • 5xx Server errors