Geplante Kontingent-Änderung abbrechen

DELETE /api/organizations/:organizationPublicId/pending-quota-change

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
ORG_ID="<organisations-public-id>"

curl -X DELETE "$BASE_URL/api/organizations/$ORG_ID/pending-quota-change" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Hinweise:

• Dieser Endpunkt erwartet keinen Request Body. Er schließt die aktuell geplante Kontingent-Reduzierung der Organisation; mehr als eine gibt es nie.
• Eine Kontingent-Reduzierung wird nicht sofort wirksam. Nach AGB § 10.5 wird sie zum Ende des laufenden Abrechnungszeitraums geplant und als pendingQuotaChange zurückgegeben (siehe Organisation aktualisieren und Organisations-Details abrufen). Dieser Endpunkt bricht sie ab, bevor sie greift.
• Nur so behältst du den aktuellen Tarif. Die Richtung wird gegen den aktuellen — noch höheren — Tarif der Organisation bestimmt. Denselben Tarif erneut per PATCH zu senden gilt deshalb als unveränderte Anfrage und lässt die geplante Reduzierung stehen. Nur eine echte Preiserhöhung ersetzt sie, und die ändert den Tarif, statt ihn wiederherzustellen.
• Der Abbruch ist kostenlos und bis zum Wirksamwerden jederzeit möglich. Danach gibt es nichts mehr abzubrechen: Die Reduzierung ist dann der Tarif der Organisation, und der Weg zurück nach oben ist eine normale Kontingent-Erhöhung über Organisation aktualisieren.
• Erfordert Schreibzugriff auf die Organisation (Organisations-Admin oder Global Admin) aus einer uneingeschränkten Session bzw. mit einem uneingeschränkten Token — dieselbe Autorisierung wie Organisation aktualisieren. Ein kundenspezifisch eingeschränktes API-Token kann diesen Endpunkt nicht aufrufen, auch nicht mit admin-Rolle: Der Abbruch verändert, was die Organisation ab der nächsten Periode zahlt.

Antwort (Response)

{
  "cancelled": true
}

Häufige Fehler

• 401 Unauthorized (data.code: unauthorized) wenn du nicht angemeldet bist
• 400 Invalid Organization identifier wenn :organizationPublicId weder eine Legacy-Integer-ID noch eine gültige UUID-Public-ID ist
• 403 Forbidden (data.code: forbidden) wenn du keinen Schreibzugriff auf die Organisation hast
• 403 Forbidden (data.code: customerScopedTokenForbidden) beim Aufruf mit einem kundenspezifisch eingeschränkten API-Token; dies ist eine organisationsweite Aktion und erfordert ein organisationsweites Token oder eine Session
• 404 Organization not found (ohne data.code) wenn :organizationPublicId zu keiner existierenden Organisation auflöst

Einen Fehler „nichts abzubrechen" gibt es bewusst nicht — dieser Fall ist 200 mit cancelled: false.

Siehe Fehlerliste für die vollständige Liste.