Désactiver une organisation

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

Désactive une organisation : ses membres ne peuvent plus se connecter, mais l'enregistrement et les adhésions sont conservés. Désactiver une organisation déjà désactivée ne modifie rien. Un événement organization.disabled est publié.

Requête

Champ	Type	Obligatoire	Description
`org_id`	path	oui	Identifiant de l'organisation (`org_…`).
`Idempotency-Key`	header	non	Facultatif. 16 à 64 caractères `[A-Za-z0-9_-]` ; répéter la même clé avec la même requête renvoie la même réponse.

Aucun corps de requête.

Réponse

200 OK avec l'organisation et son 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
}

Erreurs

HTTP	code	Quand
404	`not_found`	Aucune organisation avec cet identifiant n'existe dans cet environnement.
401	`unauthenticated`	L'identifiant d'authentification est absent, invalide ou révoqué.
403	`insufficient_permissions`	L'identifiant ne dispose pas de l'autorisation requise.
409	`organization_pending_deletion`	L'organisation est en attente de suppression en libre-service ; annulez d'abord la suppression.
429	`rate_limited`	La limite de débit a été dépassée ; réessayez après la période indiquée par `Retry-After`.
503	`service_unavailable`	Un service dont dépend l'API est temporairement indisponible ; réessayez après la période indiquée par `Retry-After`.

Exemple

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