Kuruluşu devre dışı bırakma

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

Bir kuruluşu devre dışı bırakır: üyeler bu kuruluşa giriş yapamaz, ancak kayıt ve üyelikler korunur. Zaten devre dışı olan bir kuruluşu tekrar devre dışı bırakmak hiçbir şeyi değiştirmez. Bir organization.disabled olayı yayımlanır.

İstek

Alan	Tür	Zorunlu	Açıklama
`org_id`	path	evet	Kuruluş kimliği (`org_…`).
`Idempotency-Key`	header	hayır	İsteğe bağlı. 16-64 karakter `[A-Za-z0-9_-]`; aynı anahtarın aynı istekle tekrarlanması aynı yanıtı döndürür.

İstek gövdesi yoktur.

Yanıt

200 OK ile kuruluş ve ETag değeri döner.

{
  "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
}

Hatalar

HTTP	code	Ne zaman
404	`not_found`	Bu ortamda bu kimliğe sahip bir kuruluş yok.
401	`unauthenticated`	Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisi gerekli izne sahip değil.
409	`organization_pending_deletion`	Kuruluş self-service silme için bekliyor; önce silme işlemini iptal edin.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

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