# API 삭제

`DELETE /v1/apis/{api_id}?confirm=true` · 권한 `apis:write`

API를 소프트 삭제합니다. `confirm=true`와 `If-Match`는 필수입니다. 이 API에 대한 애플리케이션 권한과 이를 가리키는 애플리케이션의 기본 API 설정이 같은 작업에서 제거되고, 식별자는 90일 동안 재사용할 수 없으며, 이 대상에 대해 발급된 새로고침 세션은 취소됩니다. 시스템 API는 삭제할 수 없습니다.

## 요청

| 매개변수 | 위치 | 설명 |
|---|---|---|
| `api_id` | path | API ID. |
| `confirm` | query | `true`여야 합니다. |
| `If-Match` | header | 마지막 읽기의 `ETag`(필수). |

## 응답

`204 No Content`, 본문 없음.

## 오류

| HTTP | code | 언제 |
|---|---|---|
| 404 | `not_found` | 이 환경에 그러한 API가 없습니다. |
| 409 | `conflict` | API가 시스템 API입니다. |
| 412 | `precondition_failed` | `If-Match`가 현재 버전과 일치하지 않습니다. |
| 422 | `validation_failed` | `confirm`이 누락되었거나 `true`가 아닙니다(`/confirm`). |
| 428 | `precondition_required` | `If-Match`가 누락되었습니다. |

## 예제

```bash
curl -X DELETE "https://api.eu.keenauth.com/v1/apis/api_01h455vb4pex5vsknk084sn02q?confirm=true" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "1"'
```