Supprimer une appartenance
DELETE /v1/organizations/{org_id}/memberships/{membership_id} · autorisation organizations:write
Supprime l'appartenance (motif removed_by_admin). Le dernier administrateur actif de l'organisation ne peut pas être retiré. If-Match est facultatif. La suppression est journalisée sous organization_membership.deleted.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
org_id |
chemin | oui | Identifiant de l'organisation (org_…). |
membership_id |
chemin | oui | Identifiant de l'appartenance (mem_…). |
If-Match |
en-tête | non | ETag actuel ; en cas de non-concordance, 412. |
Aucun corps de requête.
Réponse
204 No Content.
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 404 | not_found |
L'appartenance n'existe pas dans cette organisation. |
| 409 | last_org_admin |
L'appartenance est le dernier administrateur actif de l'organisation. |
| 412 | precondition_failed |
If-Match ne correspond pas à la version actuelle. |
| 401 | unauthenticated |
L'identifiant est absent, invalide ou révoqué. |
| 403 | insufficient_permissions |
L'identifiant ne dispose pas de l'autorisation requise. |
| 429 | rate_limited |
La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par Retry-After. |
Exemple
curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Données personnelles
Cet endpoint traite des données personnelles : appartenances aux organisations et invitations. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez de données personnelles sensibles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.