Rimuovi un'appartenenza
DELETE /v1/organizations/{org_id}/memberships/{membership_id} · autorizzazione organizations:write
Rimuove l'appartenenza (motivo removed_by_admin). L'ultimo amministratore attivo dell'organizzazione non può essere rimosso. If-Match è facoltativo. La rimozione viene registrata nell'audit come organization_membership.deleted.
Richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
org_id |
path | sì | ID dell'organizzazione (org_…). |
membership_id |
path | sì | ID dell'appartenenza (mem_…). |
If-Match |
header | no | ETag corrente; in caso di mancata corrispondenza 412. |
Nessun corpo della richiesta.
Risposta
204 No Content.
Errori
| HTTP | codice | Quando |
|---|---|---|
| 404 | not_found |
L'appartenenza non esiste in questa organizzazione. |
| 409 | last_org_admin |
L'appartenenza è l'ultimo amministratore attivo dell'organizzazione. |
| 412 | precondition_failed |
If-Match non corrisponde alla versione corrente. |
| 401 | unauthenticated |
La credenziale manca, non è valida o è stata revocata. |
| 403 | insufficient_permissions |
La credenziale non ha l'autorizzazione richiesta. |
| 429 | rate_limited |
È stato superato il limite di richieste; riprova dopo il periodo indicato in Retry-After. |
| 503 | service_unavailable |
Una dipendenza non è temporaneamente disponibile; riprova dopo il periodo indicato in Retry-After. |
Esempio
curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Dati personali
Questo endpoint tratta dati personali: appartenenze alle organizzazioni e inviti. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene eliminato. Non inviare in nessun campo categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale).