Üyeliği askıya alın

POST /v1/organizations/{org_id}/memberships/{membership_id}:suspend · izin organizations:write

Etkin bir üyeliği askıya alır (neden admin_suspended). Askıya alınmış bir üye, kuruluş bağlamında giriş yapamaz ve kuruluş oturumları sona erer. Kuruluşun son etkin yöneticisi askıya alınamaz. Zaten askıya alınmış bir üyelik için hiçbir şey yazılmaz. Yazma işlemi change=suspended ile organization_membership.updated olarak denetlenir.

İstek

Alan Tür Zorunlu Açıklama
org_id path evet Kuruluş kimliği (org_…).
membership_id path evet Üyelik kimliği (mem_…).
If-Match header hayır Mevcut ETag; verilirse eşleşmelidir (412) ve yazma o sürüme sabitlenir.

İstek gövdesi yok.

Yanıt

Güncellenmiş üyelik ve ETag değeriyle birlikte 200 OK.

{
  "id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "user_id": "usr_01j9xh2k6p7q1r3s5t7v9w1x3y",
  "status": "suspended",
  "source": "admin_api",
  "reason": "admin_suspended",
  "roles": [
    {
      "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
      "source": "admin_api",
      "assigned_at": "2026-10-12T09:31:00.123456Z"
    }
  ],
  "expires_at": null,
  "created_at": "2026-10-12T09:31:00.123456Z",
  "activated_at": "2026-10-12T09:31:00.123456Z",
  "suspended_at": "2026-10-12T10:00:00Z",
  "removed_at": null,
  "updated_at": "2026-10-12T10:00:00Z",
  "version": 2
}

Hatalar

HTTP code Ne zaman
404 not_found Üyelik bu kuruluşta mevcut değil.
409 last_org_admin Üyelik, kuruluşun son etkin yöneticisi.
412 precondition_failed If-Match, mevcut sürümle eşleşmiyor.
422 validation_failed Üyelik davet edilmiş veya kaldırılmış (/status invalid_state).
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yok.
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 -i -X POST "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c:suspend" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'

Kişisel veriler

Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veri, din, siyasi görüş, cinsel yönelim) göndermeyin.