# Kuruluş rolünü silme

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

Rolü siler. `force=true` ile atanmış bir rol de silinir ve üyelik atamaları aynı işlemde kaldırılır; aksi halde atanmış bir rol `409 role_in_use` yanıtı döndürür. Bir kuruluşun yönetici veya varsayılan üye rolü olarak kullanılan bir rol hiçbir zaman silinmez. `If-Match` isteğe bağlıdır. Silme işlemi `role.deleted` olarak denetim kaydına geçirilir.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `org_id` | path | evet | Kuruluş kimliği (`org_…`). |
| `role_id` | path | evet | Rol kimliği (`rol_…`). |
| `force` | query | hayır | `true` ise rolün atamalarını da kaldırır; `false` (varsayılan) atanmış bir rolü reddeder. |
| `If-Match` | header | hayır | Mevcut `ETag`; uyuşmazlık durumunda `412`. |

İstek gövdesi yoktur.

## Yanıt

`204 No Content`.

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Rol bu kapsamda mevcut değil. |
| 409 | `role_in_use` | Rol atanmış ve `force` `true` değil ya da rol bir kuruluşun yönetici veya varsayılan üye rolü. |
| 412 | `precondition_failed` | `If-Match` mevcut sürümle eşleşmiyor. |
| 422 | `validation_failed` | `force` `true` veya `false` değil ya da tekrarlanmış. |
| 401 | `unauthenticated` | Kimlik bilgisi eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisi gerekli izne sahip değil. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

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