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
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 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).