Fehler und Grenzen

Fehler kommen als JSON mit festem Code und englischer Meldung. Grenze: 120 Anfragen pro Minute und Schlüssel, danach 429 mit retry-after.

Die technische Referenz unten ist auf Englisch, genau so, wie Namen und Felder in der API und in Claude erscheinen.

{"error": {"code": "apikey_scope_fehlt", "message": "This API key does not have the scope 'contacts:write'."}}

BadRequest	Invalid request (`bad_request`, `idempotency_key_invalid`, ...)
Unauthorized	Missing or invalid API key (`unauthorized`)
Forbidden	The key lacks the required scope (`forbidden`, key `apikey_scope_fehlt`), the account is blocked (`account_blocked`), or a plan limit is reached (`limit_reached`).
NotFound	Not found (or belongs to another account)
Conflict	The current state does not allow the action (e.g. `webhook_limit_reached`, `idempotency_in_progress`)
UnprocessableEntity	Idempotency key reused with a different request body or path (`idempotency_key_mismatch`)
RateLimited	Too many requests for this key (120 per minute), code `rate_limited`
ServiceUnavailable	The account status could not be checked (`status_unavailable`). The API deliberately does NOT let the request through (fail-closed); retry in a minute.

Feld	Typ	Pflicht	Beschreibung
`error`	object	ja
`error.code`	string	ja	Stable machine code, e.g. not_found, rate_limited.
`error.key`	string	ja	Finer stable identifier for programmatic handling.
`error.message`	string	ja	Human-readable English text. Do not branch on it.

Fragen?