Üyeyi kaldır

DELETE /fapi/v1/organizations/{org_id}/memberships/{membership_id} · ortamın oturum açma ana bilgisayarından çağrılır

Bir üyeyi kuruluştan kaldırır. Üyelik removed durumuna geçer ve kullanıcının bu kuruluşa ait oturumları ve belirteçleri iptal edilir; hesabı ve diğer kuruluşları etkilenmez.

Kimliği doğrulanmış kullanıcının, tam bir Origin ile birlikte __Host-idp_session çerezi gerekir; ya da birinci taraf bir uygulamanın ön uç API erişim belirteci (Authorization: DPoP <token> ve bir DPoP kanıtı ile; bkz. Ön uç API erişim belirteci). Kullanıcının kuruluşun etkin bir üyesi olması ve idp_members:remove iznine sahip olması gerekir. Üye olmayan bir kullanıcı 404 not_found alır; izni olmayan bir üye 403 insufficient_permissions alır.

Üye kaldırmak hassas bir işlemdir: kullanıcının son 5 dakika içinde oturum açmış olması gerekir. Aksi takdirde yanıt, max_age=300 belirten bir WWW-Authenticate ile birlikte 401 step_up_required olur; kullanıcıyı maxAge: 300 ile yeniden oturum açtırın ve isteği tekrarlayın. Bu denetim, kuruluşla ilgili herhangi bir bilgi okunmadan önce yapılır.

Kendi üyeliğinizi burada kaldıramazsınız (403 insufficient_permissions).
Ayrıcalıklı bir rol taşıyan bir üyeyi yalnızca yönetici rolüne sahip bir üye kaldırabilir (403 role_not_assignable).
Son etkin yönetici kaldırılamaz (409 last_org_admin).

@keenauth/js ile: await keenauth.organizations.removeMember(orgId, membershipId).

İstek

Üstbilgiler:

Üstbilgi	Zorunlu	Açıklama
`Idp-Client`	evet	SDK tanımlayıcısı.
`Origin`	evet, çerezle birlikte	`https://<sign-in host>`.
`If-Match`	hayır	Üye listesinden alınmış tek bir sürüm, `"<version>"`. Eşleşmeyen bir sürüm veya birden fazla sürüm `412 precondition_failed` döndürür.

org_id: kuruluş tanımlayıcısı (org_…). membership_id: üyelik tanımlayıcısı (mem_…).

Gövde yok.

Yanıt

204 No Content.

Hatalar

Durum	Kod	Ne zaman
400	`malformed_request`	`If-Match` hatalı biçimlendirilmişse.
401	`unauthenticated`	Geçerli bir oturum çerezi veya belirteci yoksa.
401	`step_up_required`	Kullanıcı 5 dakikadan daha önce oturum açmışsa.
403	`insufficient_permissions`	Kullanıcıda `idp_members:remove` yoksa ya da üyelik kullanıcının kendisine aitse.
403	`role_not_assignable`	Üye ayrıcalıklı bir rol taşıyorsa ve kullanıcı yönetici rolüne sahip değilse.
403	`origin_not_allowed`	`Origin` eşleşmiyorsa.
404	`not_found`	Bu kullanıcı için böyle bir kuruluş veya üyelik yoksa; bilinmeyen, hatalı biçimlendirilmiş veya başkasına ait tanımlayıcı aynı yanıtı verir.
409	`last_org_admin`	Üye kuruluşun son etkin yöneticisiyse.
409	`organization_disabled`	Kuruluş devre dışıysa veya silinmek üzere bekliyorsa (`organization_pending_deletion`).
412	`precondition_failed`	`If-Match`, üyeliğin geçerli sürümünü belirtmiyorsa.
503	`service_unavailable`	Geçici olarak kullanılamıyor; `Retry-After` değerinden sonra yeniden deneyin.

Örnek

curl -X DELETE "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/memberships/mem_01jbz6x8kq3m2n4p5r6s7t8v9b" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt

Kişisel veriler

Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler sayfası 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 veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.