
# 管理クライアントの削除

`DELETE /v1/management-clients/{application_id}` · 権限 `management-clients:write`

アプリケーションの管理クライアントのレコードを削除します。アプリケーションとその資格情報は残ります。アプリケーション自体を削除すると(`DELETE /v1/applications/{application_id}`)、このレコードも削除されます。その後、このエンドポイントと `GET` は `404` を返します。`If-Match` は必須です。指定しないとリクエストは `428` で失敗し、現在のバージョンと一致しない場合は `412` で失敗します。このエンドポイントを呼び出せるのは API キーだけです。

## リクエスト

| パラメータ | 位置 | 説明 |
|---|---|---|
| `application_id` | パス | アプリケーション ID(`app_…`)。 |
| `If-Match` | ヘッダー | 直前の読み取りまたは書き込みで得た `ETag`。 |

## レスポンス

`204 No Content`

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 403 | `insufficient_permissions` | 資格情報に `management-clients:write` がない、または API キーではありません。 |
| 403 | `permission_escalation` | レコードが呼び出しキーより広い権限を持っています。 |
| 404 | `not_found` | このアプリケーションにはこの環境でレコードがありません。 |
| 412 | `precondition_failed` | `If-Match` が現在のバージョンと一致しません。 |
| 428 | `precondition_required` | `If-Match` がありません。 |

## 例

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/management-clients/app_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"'
```

CLI: `keenauth management-clients delete app_01h455vb4pex5vsknk084sn02q --if-match '"3f2a9c0d7b1e4a6f8c5d2e1b0a9f8e7d"' --yes`
