# 조직 역할 삭제

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

역할을 삭제합니다. `force=true`를 지정하면 할당된 역할도 삭제되며, 해당 멤버십 할당도 같은 작업에서 제거됩니다. 그렇지 않으면 할당된 역할에 대해 `409 role_in_use`가 반환됩니다. 조직의 관리자 역할 또는 기본 멤버 역할로 사용 중인 역할은 삭제되지 않습니다. `If-Match`는 선택 사항입니다. 삭제는 `role.deleted`로 감사됩니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `org_id` | 경로 | 예 | 조직 ID (`org_…`)입니다. |
| `role_id` | 경로 | 예 | 역할 ID (`rol_…`)입니다. |
| `force` | 쿼리 | 아니요 | `true`이면 역할의 할당도 제거합니다. `false`(기본값)이면 할당된 역할의 삭제를 거부합니다. |
| `If-Match` | 헤더 | 아니요 | 현재 `ETag`입니다. 일치하지 않으면 `412`가 반환됩니다. |

요청 본문은 없습니다.

## 응답

`204 No Content`.

## 오류

| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | `not_found` | 이 범위에 역할이 존재하지 않습니다. |
| 409 | `role_in_use` | 역할이 할당되어 있고 `force`가 `true`가 아니거나, 조직의 관리자 역할 또는 기본 멤버 역할입니다. |
| 412 | `precondition_failed` | `If-Match`가 현재 버전과 일치하지 않습니다. |
| 422 | `validation_failed` | `force`가 `true` 또는 `false`가 아니거나 반복되어 있습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나, 유효하지 않거나, 취소되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 필요한 권한이 없습니다. |
| 429 | `rate_limited` | 요청 한도를 초과했습니다. `Retry-After` 기간이 지난 후 다시 시도하십시오. |
| 503 | `service_unavailable` | 종속 서비스를 일시적으로 사용할 수 없습니다. `Retry-After` 기간이 지난 후 다시 시도하십시오. |

## 예시

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