Errors

All error responses use the same JSON format:

{
  "error": "Human-readable description of what went wrong.",
  "code": "MACHINE_READABLE_CODE"
}

The code field is only present on certain errors.

HTTP status codes

Status	Meaning
`200`	Success
`201`	Resource created
`400`	Bad request: malformed input
`401`	Unauthenticated: missing or invalid API key
`403`	Forbidden: you lack permission for this action
`404`	Not found: resource does not exist or does not belong to your organization
`422`	Unprocessable entity: validation failed
`429`	Rate limit exceeded
`500`	Internal server error

Validation errors (422) include a field-level breakdown:

{
  "errors": {
    "name": ["Name is required"],
    "description": ["Must be at most 500 characters"]
  }
}

A 404 on a resource that exists may mean it belongs to a different organization than the one your key is scoped to.
403 responses with "code": "SUBSCRIPTION_REQUIRED" mean your current plan does not support this action.