Errors

Branch on the stable code. Do not parse a human sentence.

Mechanism

The codes on this page are the codes that exist: 401 auth, 403 tenant, 404 unknown tenant, 422 validation (and request_invalid on a bad sandbox reset), 429 plus Retry-After, 501 unsupported / parked capability, 500 opaque internal_error.

What the caller sees

The body is code, message, and doc_url. details is optional.

HTTP 422
{
  "code": "validation",
  "message": "The request did not validate.",
  "doc_url": "https://docs.bitlync.com/concepts/errors/"
}

500 stays opaque. A parked write is 501, not a generic 500.

Health, incidents, and audit are listed reads on Reference, not a new UI.