
# 내 계정 삭제

`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>`이어야 합니다. |

본문:

```json
{}
```

## 응답

`202 Accepted`:

```json
{"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` 이후에 다시 시도하십시오. |

## 예시

```bash
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의 개인정보](/docs/policies/personal-data)에서 저장되는 항목, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 指向)를 보내지 마십시오.
