Fehlercodes

Was jeder Fehler bedeutet, den die API zurückgibt, und was dann zu tun ist.

Generiert

Prüfen Sie den Code einer Ablehnung, nie ihre Meldung: Der Code bleibt stabil, die Worte können sich ändern.

Eine Ablehnung: {"error": {"code": …, "message": …}}
Aus eigenem Grund abgelehnt: {"error": {"code": …, "message": …, "reason": …}}
Zu viele Anfragen: Retry-After: 30
Über MCP: Ein Werkzeugfehler, dessen data denselben Code trägt.

Jeder Aufruf

Code	Status	Bedeutung	Was zu tun ist
`invalid_parameter`	400	Ein Parameter hat den falschen Typ oder Wert; die Meldung nennt ihn.	Korrigieren Sie den Wert und senden Sie die Anfrage erneut.
`invalid_request`	400	Die Anfrage lässt sich so nicht ausführen; die Meldung sagt, warum.	Lesen Sie die Meldung, korrigieren Sie die Anfrage und senden Sie sie erneut.
`unknown_parameter`	400	Ein Parameter, den die Funktion nicht kennt.	Prüfen Sie die Parameter der Funktion in dieser Referenz.
`invalid_token`	401	Das Token fehlt, wurde widerrufen oder ist abgelaufen.	Erstellen Sie ein Token unter Meine Einstellungen → API-Tokens und melden Sie sich erneut an (cw login).
`access_denied`	403	Ihre Rolle erlaubt das hier nicht.	Bitten Sie einen Admin des Namespace um eine Rolle, die das in dieser Umgebung erlaubt.
`api_not_available`	403	Die API ist für keinen der Namespaces des Tokens freigegeben.	Bitten Sie den Support, die API für Ihren Namespace freizugeben.
`function_not_allowed`	403	Das Token enthält diese Funktion nicht.	Bearbeiten Sie das Token unter Meine Einstellungen → API-Tokens und haken Sie die Funktion an.
`rate_limited`	429	Zu viele Anfragen: 120 pro Minute und Token, und 10 Änderungen pro Minute.	Warten Sie die Sekunden, die der Retry-After-Header nennt, und versuchen Sie es dann erneut.
`internal_error`	500	Auf Seiten der Plattform ist etwas fehlgeschlagen.	Versuchen Sie es erneut; schlägt es weiter fehl, wenden Sie sich an den Support.

Code	Status	Bedeutung	Was zu tun ist
`not_found`	404	Kein solcher Datensatz in den Namespaces des Tokens — oder keine solche Funktion auf dieser Plattform.	Listen Sie zuerst die Datensätze auf, um die ID zu finden; eine ältere Plattform bietet die Funktion vielleicht noch nicht an.

Code	Status	Bedeutung	Was zu tun ist
`namespace_not_found`	404	Das Token hat keinen solchen Namespace.	Verwenden Sie einen Code, den cw namespaces (oder whoami) auflistet.

Code	Status	Bedeutung	Was zu tun ist
`writes_disabled`	403	Änderungen über die API sind für Ihr Konto noch nicht freigeschaltet; Lesen funktioniert weiterhin.	Nehmen Sie die Änderung im Dashboard vor, oder bitten Sie den Support, Änderungen über die API für Ihr Konto freizuschalten.
`request_in_progress`	409	Die erste Anfrage mit diesem Idempotency-Key läuft noch.	Warten Sie einen Moment und senden Sie sie dann mit demselben Schlüssel erneut.
`idempotency_key_reused`	422	Dieser Idempotency-Key wurde für eine andere Anfrage verwendet.	Verwenden Sie für eine neue Änderung einen neuen Schlüssel.
`locked`	423	Die Sicherheitssperre der Plattform hält Ausführungen gerade an.	Versuchen Sie es später erneut.
`idempotency_key_required`	428	Eine Änderung braucht einen Idempotency-Key-Header.	Senden Sie mit jeder Änderung einen neuen, eindeutigen Schlüssel — und denselben, wenn Sie sie wiederholen.

Code	Status	Bedeutung	Was zu tun ist
`missing_parameter`	400	Ein Pflichtparameter fehlt.	Senden Sie ihn mit: Diese Referenz kennzeichnet ihn als Pflicht.
`plan_required`	403	Der Tarif des Projekts enthält das nicht.	Wechseln Sie in einen höheren Tarif des Projekts oder fragen Sie den Admin des Namespace.
`not_a_change`	405	Diese Funktion liest: Sie wird mit GET aufgerufen, nicht mit POST.	Senden Sie sie als GET.
`in_progress`	409	Auf der App läuft gerade etwas, und die Änderung würde es abbrechen.	Warten Sie, bis es fertig ist (cw runs --app), und versuchen Sie es dann erneut.
`not_deployed`	409	Die App wurde noch nicht bereitgestellt, es gibt also nichts zu ändern.	Stellen Sie sie zuerst im Dashboard bereit.
`not_retryable`	409	Die Ausführung kann nicht wiederholt werden; reason sagt, warum (eine neuere Ausführung, ihre Warteschlange, nichts ist fehlgeschlagen…).	Folgen Sie dem Grund: Wiederholen Sie die neuere Ausführung oder starten Sie die Änderung neu.
`retry_coming`	409	Eine automatische Wiederholung dieser Ausführung steht in wenigen Minuten an.	Warten Sie darauf oder wiederholen Sie jetzt mit now: true.
`upgrade_standby`	409	Ein Versions-Upgrade hält die App fest.	Schließen Sie das Upgrade zuerst im Dashboard ab oder brechen Sie es ab.
`unavailable`	503	Die Plattform kann das gerade nicht beantworten (ein Dienst, den sie liest, ist nicht erreichbar).	Versuchen Sie es in ein paar Minuten erneut.

Ihre Antwort hilft uns, Verbesserungen an der Dokumentation zu priorisieren.