Skip to main content

Error format

Errors use standard HTTP status codes and a JSON body:
Branch on code, not message. Messages are written for people and can change.

Codes

Each operation in the API reference lists the codes it can return.

Request IDs

Every response has an x-request-id header, such as req_3f9c…. Log it. If something looks wrong, send us the request ID and we can find exactly what happened.

Rate limits

Limits apply per OAuth client, with separate budgets for reads and writes: Every response includes RateLimit-Limit and RateLimit-Remaining. Over the limit, you get 429 RATE_LIMITED with a Retry-After header in seconds. Wait that long, then retry with the same idempotency key.

Retrying