Error format
Errors use standard HTTP status codes and a JSON body: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 anx-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.