Eine Organisation deaktivieren

POST /v1/organizations/{org_id}:disable · Berechtigung organizations:write

Deaktiviert eine Organisation: Mitglieder können sich nicht bei ihr anmelden, während der Datensatz und die Mitgliedschaften erhalten bleiben. Das Deaktivieren einer bereits deaktivierten Organisation ändert nichts. Ein Ereignis organization.disabled wird veröffentlicht.

Anfrage

Feld	Typ	Pflicht	Beschreibung
`org_id`	path	ja	Organisations-ID (`org_…`).
`Idempotency-Key`	header	nein	Optional. 16–64 Zeichen `[A-Za-z0-9_-]`; die Wiederholung desselben Schlüssels mit derselben Anfrage liefert dieselbe Antwort.

Kein Anfragetext.

Antwort

200 OK mit der Organisation und ihrem ETag.

{
  "id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "name": "Acme Corp",
  "slug": "acme",
  "external_id": "crm-4821",
  "status": "disabled",
  "metadata": {
    "tier": "gold"
  },
  "brand_color": "#1F6FEB",
  "max_memberships": null,
  "default_zoneinfo": null,
  "created_via": "admin_api",
  "disabled_at": "2026-10-12T10:05:00.654321Z",
  "deletion_requested_at": null,
  "deletion_due_at": null,
  "created_at": "2026-10-12T09:30:00.123456Z",
  "updated_at": "2026-10-12T10:05:00.654321Z",
  "version": 2
}

Fehler

HTTP	Code	Wann
404	`not_found`	Unter dieser ID existiert in dieser Umgebung keine Organisation.
401	`unauthenticated`	Die Anmeldedaten fehlen, sind ungültig oder widerrufen.
403	`insufficient_permissions`	Den Anmeldedaten fehlt die erforderliche Berechtigung.
409	`organization_pending_deletion`	Die Organisation wartet auf ihre Self-Service-Löschung; brechen Sie zuerst die Löschung ab.
429	`rate_limited`	Das Rate-Limit wurde überschritten; wiederholen Sie die Anfrage nach Ablauf der Zeit aus `Retry-After`.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Ablauf der Zeit aus `Retry-After`.

Beispiel

curl -X POST "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a:disable" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"