
# Mitgliedschaft entfernen

`DELETE /v1/organizations/{org_id}/memberships/{membership_id}` · Berechtigung `organizations:write`

Entfernt die Mitgliedschaft (Grund `removed_by_admin`). Der letzte aktive Administrator der Organisation kann nicht entfernt werden. `If-Match` ist optional. Die Entfernung wird als `organization_membership.deleted` protokolliert.

## Anfrage

| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `org_id` | Pfad | ja | ID der Organisation (`org_…`). |
| `membership_id` | Pfad | ja | ID der Mitgliedschaft (`mem_…`). |
| `If-Match` | Header | nein | Aktueller `ETag`; bei Abweichung `412`. |

Kein Anfragetext.

## Antwort

`204 No Content`.

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | Die Mitgliedschaft existiert in dieser Organisation nicht. |
| 409 | `last_org_admin` | Die Mitgliedschaft ist der letzte aktive Administrator der Organisation. |
| 412 | `precondition_failed` | `If-Match` stimmt nicht mit der aktuellen Version überein. |
| 401 | `unauthenticated` | Die Anmeldedaten fehlen, sind ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Die Anmeldedaten haben nicht die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Wartezeit aus `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Wartezeit aus `Retry-After`. |

## Beispiel

```bash
curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Organisationsmitgliedschaften und Einladungen. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).
