管理クライアントの削除
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 がありません。 |
例
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