DokumentationProdukteShellBaseRichtlinien-APIRichtlinien-API V1

Richtlinie löschen

2 min Lesezeit · zuletzt aktualisiert 18. August 2026

In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.

Löscht eine Richtlinie.

Wer sie nur vorübergehend aussetzen will, setzt enabled: false — das bleibt nachvollziehbar.

DELETE https://policies.api.shellbase.artim-industries.com/v1/policies/{id}
MethodeDELETE
Basispolicies.api.shellbase.artim-industries.com/v1
Scopesb.policies:delete
Antwort204
ZugangDeveloper Mitgliedschaft
AuthAuthorization: Bearer sbapi_…

Parameter

ParameterOrtTypPflichtBedeutung
idPfadstringjaKennung der Richtlinie.

Anfragekörper

Dieser Endpunkt braucht keinen Körper.

Anfrage

curl -X DELETE "https://policies.api.shellbase.artim-industries.com/v1/policies/{id}" \
  -H "Authorization: Bearer sbapi_…"

Antwort

204 No Content — die Antwort hat keinen Körper.

Fehler

StatuscodeWann
400invalid_requestEin Pflichtfeld fehlt, ein Typ passt nicht, oder ein Verweis zeigt auf etwas, das es hier nicht gibt.
401invalid_tokenBearer fehlt, ist unbekannt oder abgelaufen.
403missing_scopeDas Token trägt den Scope dieses Endpunkts nicht.
404not_foundDer Eintrag gehört nicht zum freigegebenen Team — oder die Anfrage kam auf der falschen Subdomain an.
409conflictDer Zustand verbietet die Änderung — der Fehlerkörper nennt den Grund.
429rate_limitedKontingent erschöpft, siehe Retry-After.

Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.

Rate Limits

Das Limit gilt pro Team, nicht pro Token.

ZugangProduktionSandbox
Hobby60 Anfragen/Minuteohne Limit
Developer Mitgliedschaft10.000 Anfragen/Minuteohne Limit

Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.