Guides
Short, precise guides to the conventions every operation shares. Read these once and the whole API behaves the way you expect.
Bearer tokens, permission scopes, and scoped agent keys. How each surface authenticates today, documented as it is.
ErrorsOne error envelope everywhere: stable machine-readable codes, human-readable messages, and a requestId for support.
IdempotencyRetry any write safely. The Idempotency-Key header, which operations require it, and how replays behave.
Rate limitsEvery operation is rate limited. What a 429 looks like, the Retry-After header, and how to back off well.
Versioning and changelogThe v1 contract is stable and additive. How the spec, SDKs and these docs are generated from one contract.