# Ü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](/docs/api/fapi/front-api-token)). 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

```bash
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](/docs/policies/personal-data) 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.