​

Errors and Rate Limits

​

Error Envelope

{
  "code": "string",
  "message": "string",
  "details": {},
  "request_id": "string"
}

​

Core Error Codes

• BAD_REQUEST (400)
• UNAUTHORIZED (401)
• NOT_FOUND (404)
• TOO_MANY_REQUESTS (429)
• INTERNAL_ERROR (500)

​

Rate Limit Behavior

• Rate limits apply per API key.
• 429 responses include Retry-After.
• Clients should use exponential backoff for retries.