Errors use { error: { message, code?, fields? } }. Unknown JSON properties are rejected where the operation schema says so.
- 400 — the body or query failed validation.
fieldslists the problems. - 401 — the key is missing, unknown, or revoked.
- 403 — the key is valid and does not have the scope, or the key has no practice.
- 404 — the record is not in the key's practice, or it does not exist. Those two cases look the same.
- 409 — an idempotency key was reused with a different body, or a status transition is not allowed.
- 412 —
entity_versionis stale. - 428 — a required
Idempotency-Keyorentity_versionwas missing. - 429 — the key exceeded 600 requests in the current minute.