Rate limits and errors

How many requests you can make, and what error responses look like.

Rate limits

Each API key and each OAuth connection can make 120 requests per minute. Over the limit, you get 429 Too Many Requests with a Retry-After header saying how many seconds to wait.

Errors

Errors return JSON with a stable code, a message, a hint on how to fix it, and a link to the API description. error repeats the message for older clients:

{
  "error": "Not found",
  "code": "not_found",
  "message": "Not found",
  "hint": "The resource does not exist or belongs to another Workspace. Endpoints live under /api/v1; see the OpenAPI description.",
  "docs": "/api/v1/openapi.json"
}

Unknown paths under /api return the same shape with status 404.