# Eliminare un ruolo dell'organizzazione

`DELETE /v1/organizations/{org_id}/roles/{role_id}` · autorizzazione `roles:write`

Elimina il ruolo. Con `force=true` viene eliminato anche un ruolo assegnato e le sue assegnazioni ai membri vengono rimosse nella stessa operazione; altrimenti un ruolo assegnato restituisce `409 role_in_use`. Un ruolo usato come ruolo di amministratore o di membro predefinito dell'organizzazione non viene mai eliminato. `If-Match` è facoltativo. L'eliminazione viene registrata nel log di audit come `role.deleted`.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `org_id` | path | sì | ID dell'organizzazione (`org_…`). |
| `role_id` | path | sì | ID del ruolo (`rol_…`). |
| `force` | query | no | `true` rimuove anche le assegnazioni del ruolo; `false` (predefinito) rifiuta un ruolo assegnato. |
| `If-Match` | header | no | `ETag` corrente; in caso di mancata corrispondenza `412`. |

Nessun corpo della richiesta.

## Risposta

`204 No Content`.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | Il ruolo non esiste in questo ambito. |
| 409 | `role_in_use` | Il ruolo è assegnato e `force` non è `true`, oppure è il ruolo di amministratore o di membro predefinito dell'organizzazione. |
| 412 | `precondition_failed` | `If-Match` non corrisponde alla versione corrente. |
| 422 | `validation_failed` | `force` non è `true` o `false`, oppure è ripetuto. |
| 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 è temporaneamente non disponibile; riprova dopo il periodo indicato in `Retry-After`. |

## Esempio

```bash
curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/roles/rol_01j9xr7s1t2w6x8y0z2a4b6c8e?force=true" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```