Errors
Non-2xx responses use a problem-details body. Handle the code rather than parsing the human-readable title.
Authentication and access
401 invalid_token: the credential is missing, expired, malformed or revoked.
403 insufficient_scope: the credential’s scopes or member permissions do not cover the action.
404 not_found: the resource does not exist in the addressed workspace or is not accessible.
Validation and conflicting writes
422 validation_failed: inspect the errors field for invalid input.
409 conflict: the operation does not fit the resource’s current state.
412 precondition_failed: If-Match did not match the current ETag. Fetch the latest resource before retrying.
Limits and retries
429 rate_limited: respect Retry-After and the rate-limit headers.
403 plan_limit_reached or feature_locked: the workspace’s plan does not allow this operation.
503 gateway_unavailable or pdf_unavailable: a required service could not complete the operation.