관리 클라이언트 삭제
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