지원 액세스 권한 부여 취소
DELETE /v1/support-access-grants/{grant_id} · 권한 support-access-grants:write
만료 전에 지원 액세스 권한 부여를 취소합니다. revoked_at이 설정되고, 이 권한에 근거한 담당자 액세스가 종료되며 support_access_grant.revoked 이벤트가 게시됩니다. 레코드는 감사를 위해 보관됩니다. 이미 취소되었거나 만료된 권한 부여를 취소해도 아무것도 변경되지 않으며 여전히 204를 반환합니다. 최근 5분 이내에 다시 로그인한 owner 또는 admin이 대시보드에서만 취소할 수 있습니다. API 키와 머신 클라이언트는 403 insufficient_permissions를 받습니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
grant_id |
string | 예 | 권한 부여 ID(sag_…). |
요청 본문 없음.
응답
204 No Content.
오류
| HTTP | code | 조건 |
|---|---|---|
| 404 | not_found |
권한 부여가 없거나 다른 환경에 속합니다. |
| 403 | insufficient_permissions |
요청이 대시보드에서 owner 또는 admin이 보낸 것이 아니거나, 자격 증명에 필요한 권한이 없습니다. |
| 401 | unauthenticated |
자격 증명이 없거나 유효하지 않거나 취소되었습니다. |
| 429 | rate_limited |
속도 제한을 초과했습니다. Retry-After 기간이 지난 후 다시 시도하세요. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간이 지난 후 다시 시도하세요. |
예제
생성과 취소는 대시보드 작업입니다. 대시보드가 보내는 요청:
DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a