Admin Portal 링크 취소
DELETE /v1/admin-portal-links/{link_id} · 권한 admin-portal-links:write
링크를 취소하며, 이 링크가 연 모든 포털 세션은 즉시 종료됩니다. 이미 취소된 링크를 취소해도 204를 반환하며, 새로운 감사 기록은 작성되지 않습니다. 취소는 admin_portal_link.revoked로 감사됩니다.
요청
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
link_id |
path | 예 | 링크 ID(apl_…). |
요청 본문은 없습니다.
응답
204 No Content.
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 링크가 존재하지 않습니다. |
| 401 | unauthenticated |
자격 증명이 없거나 유효하지 않거나 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오. |
예제
curl -i -X DELETE "https://api.eu.keenauth.com/v1/admin-portal-links/apl_01j9xv2c4d6e8f0g2h4j6k8m0n" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"