# Supprimer un rôle d'organisation

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

Supprime le rôle. Avec `force=true`, un rôle attribué est lui aussi supprimé et ses attributions d'appartenance sont retirées dans la même opération ; sinon, un rôle attribué renvoie `409 role_in_use`. Un rôle utilisé comme rôle d'administrateur ou rôle de membre par défaut d'une organisation n'est jamais supprimé. `If-Match` est facultatif. La suppression est journalisée sous `role.deleted`.

## Requête

| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| `org_id` | path | oui | Identifiant de l'organisation (`org_…`). |
| `role_id` | path | oui | Identifiant du rôle (`rol_…`). |
| `force` | query | non | `true` supprime aussi les attributions du rôle ; `false` (par défaut) refuse un rôle attribué. |
| `If-Match` | header | non | `ETag` actuel ; en cas de non-concordance, `412`. |

Aucun corps de requête.

## Réponse

`204 No Content`.

## Erreurs

| HTTP | code | Cas |
|---|---|---|
| 404 | `not_found` | Le rôle n'existe pas dans ce périmètre. |
| 409 | `role_in_use` | Le rôle est attribué et `force` n'est pas `true`, ou il est le rôle d'administrateur ou de membre par défaut d'une organisation. |
| 412 | `precondition_failed` | `If-Match` ne correspond pas à la version actuelle. |
| 422 | `validation_failed` | `force` n'est ni `true` ni `false`, ou il est répété. |
| 401 | `unauthenticated` | Le justificatif est absent, invalide ou révoqué. |
| 403 | `insufficient_permissions` | Le justificatif 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 période `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la période `Retry-After`. |

## Exemple

```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"
```