Skip to main content

Error Codes

API error responses and troubleshooting

HTTP status codes

StatusMeaningAction
200Success—
400Bad requestCheck parameters
401Auth failureCheck API Key
403ForbiddenRequest permissions
404Not foundVerify ID
429Rate limitedBackoff and retry
500Server errorRetry

Error response

{
  "code": "InvalidParameter",
  "message": "user_id is required",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Retry strategy

Error typeRetry?Interval
4xx (except 429)No—
429 rate limitedYes1s/2s/4s exponential backoff
5xxYes1s/2s/4s, max 3 retries

Troubleshooting

Every response includes request_id, which helps locate the relevant logs quickly.
See Rate limits for throttling details.