Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Errors and limits

Every error is { "error": { "code", "message", "requestId" } } and the x-request-id header carries the same id.
Codes: unauthenticated 401, forbidden 403, not_found 404, invalid_request 400, conflict 409, idempotency_mismatch 422, payload_too_large 413, rate_limited 429, policy_denied 403, payment_required 402, internal 500.
Each key allows 600 requests a minute with a burst of 120. Responses carry x-ratelimit-limit and x-ratelimit-remaining; a 429 carries retry-after. Request bodies are limited to about 1 MB. Writes need an Idempotency-Key; reusing a key with a different request is idempotency_mismatch.