Fehlercodes
Jeder code aus dem Problem-Körper
(RFC 9457)
mit eigenem Anker — das type-Feld jeder Fehlerantwort zeigt genau
hierher. Die vollständige Tabelle mit Status steht auch auf der
Übersichtsseite.
400 bad_request
Eine Abhängigkeit hat die Anfrage ohne eigenen Code abgelehnt; der Status richtet sich nach jener Abhängigkeit.
401 unauthorized
Schlüssel fehlt, unbekannt, falsch, abgelaufen, widerrufen oder die IP ist nicht zugelassen — ein Code für alle Gründe.
403 insufficient_scope
Der Scope für diese Operation fehlt; detail nennt ihn.
403 privacy_restricted
Das Team hat Einzelwerte ausgeschaltet (member_detail_enabled).
403 api_disabled
Mandant gesperrt oder beendet.
403 vorgabe_gesperrt
Eine Vorgabe, die für den Empfänger gilt, sperrt diese Situation, Persönlichkeit oder Branche (nur bei Zuweisungen).
404 not_found
Nicht vorhanden oder einem anderen Mandanten gehörend — von außen nicht unterscheidbar.
409 conflict
Die E-Mail-Adresse gehört bereits einem Mitglied des Teams oder dessen Inhaber, oder ein gleichzeitiger zweiter Aufruf mit demselben Idempotency-Key läuft noch.
409 seat_limit_reached
Alle Sitze des Teams sind belegt.
409 last_admin
Das Mitglied ist der letzte aktive admin; Rollenwechsel oder Entfernen würde das Team ohne Administrator zurücklassen.
409 owner
Der Inhaber des Teams kann über die Schnittstelle weder entfernt noch in der Rolle geändert werden.
422 validation_error
Eine Query-, Pfad- oder Körperangabe ist ungültig. Ein beim Einlesen der Anfrage erkannter Formfehler trägt errors (eine Liste); ein von der Anwendung geprüfter Fachfehler trägt stattdessen field (genau ein Feldname).
422 idempotency_mismatch
Idempotency-Key wurde mit einem anderen Körper wiederverwendet.
422 kombination_ungueltig
Die Situation, Persönlichkeit oder Branche ist unbekannt, für das Team nicht sichtbar oder verletzt eine Katalogregel (nur bei Zuweisungen).
429 rate_limited
Grenze erreicht; Retry-After nennt die Wartezeit in Sekunden.
500 internal
Unerwarteter Fehler; der Körper verrät bewusst keine Interna — request_id hilft beim Support.