組織の削除を取り消す

POST /v1/organizations/{org_id}:cancel-deletion · 権限 organizations:write

組織管理者がセルフサービスで deletion_due_at より前に要求した削除を取り消します。組織は再び active になります。削除待ちではない組織の場合、何も変更されません。organization.deletion_cancelled イベントが発行されます。

リクエスト

フィールド 型 必須 説明
org_id path はい 組織 ID(org_…)。
Idempotency-Key header いいえ 任意。16〜64 文字の [A-Za-z0-9_-]。同じキーで同じリクエストを繰り返すと、同じレスポンスが返されます。

リクエストボディはありません。

レスポンス

組織と、その ETag を含めて 200 OK を返します。

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

エラー

HTTP code 発生条件
404 not_found この環境に、この ID の組織が存在しません。
401 unauthenticated 認証情報が未指定、無効、または取り消し済みです。
403 insufficient_permissions 認証情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間を待ってから再試行してください。
503 service_unavailable 依存するサービスが一時的に利用できません。Retry-After の期間を待ってから再試行してください。

例

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