# マイアカウントの削除

`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` | 有効なセッション Cookie がない。 |
| 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)では、保存される内容、保管期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。