내 계정 삭제
POST /fapi/v1/me/deletion · 환경의 로그인 호스트에서 호출
로그인한 사용자 본인의 계정 삭제를 예약합니다. 계정은 환경의 self_service_deletion_grace_days(0~30일, 기본값 14일) 동안 대기한 후 영구적으로 삭제됩니다. 값이 0이면 다음 삭제 작업 실행 시 삭제됩니다. 요청한 세션을 포함하여 사용자의 모든 세션, 갱신 토큰 및 액세스 토큰이 즉시 폐기됩니다. 대기 기간 중에는 계정 포털을 통해서만 로그인할 수 있으며, 이때도 삭제를 취소하거나 본인 데이터의 내보내기를 요청하고 다운로드하는 용도로만 사용할 수 있습니다.
최근 로그인이 필요합니다. 세션이 최근 5분 이내에 인증되지 않았거나, 사용자가 두 번째 요소를 설정했는데 세션이 이를 사용하지 않은 경우 401 step_up_required가 반환되며 아무것도 변경되지 않습니다. 같은 요청을 다시 보내면 동일한 대기 중 삭제가 반환됩니다.
조직의 마지막 활성 관리자인 사용자는 계정을 삭제할 수 없습니다. 이 경우 409 last_org_admin이 반환되며 아무것도 변경되지 않습니다. 먼저 다른 구성원에게 조직의 관리자 역할을 부여하십시오.
요청
헤더:
| 헤더 | 필수 | 설명 |
|---|---|---|
Idp-Client |
예 | SDK 식별자입니다. |
Origin |
예 | 정확히 https://<sign-in host>이어야 합니다. |
본문:
{}
응답
202 Accepted:
{"status": "scheduled", "due_at": "2026-11-10T09:30:00Z", "cancellable": true}
오류
| 상태 | 코드 | 발생 조건 |
|---|---|---|
| 401 | unauthenticated |
유효한 세션 쿠키가 없습니다. |
| 401 | step_up_required |
로그인한 지 5분이 넘었거나 두 번째 요소가 필요합니다. WWW-Authenticate 헤더에 max_age=300(두 번째 요소가 필요한 경우 acr_values 포함)이 포함됩니다. |
| 403 | origin_not_allowed |
Origin이 없거나 잘못되었습니다. |
| 403 | user_not_active |
사용자가 차단되었거나 이미 관리자에 의해 삭제가 진행 중입니다. |
| 404 | not_found |
환경에서 자가 계정 삭제가 꺼져 있습니다. |
| 409 | last_org_admin |
사용자가 조직의 마지막 활성 관리자입니다. |
| 503 | service_unavailable |
사용자 디렉터리를 일시적으로 사용할 수 없습니다. Retry-After 이후에 다시 시도하십시오. |
예시
curl -X POST https://example.keenauth.app/fapi/v1/me/deletion \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
개인정보
이 엔드포인트는 최종 사용자 프로필이라는 개인정보를 다룹니다. KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 指向)를 보내지 마십시오.