
# 自分のデータをエクスポート

`POST /fapi/v1/me/exports` · 環境のサインインホストから呼び出します

サインイン中のユーザー自身のデータのエクスポートを開始します（GDPR 第15条および第20条）。パッケージはバックグラウンドで準備されます。準備が完了すると、リクエストと同じ言語でユーザーにメールが届きます。ファイルは 7 日間、[エクスポートをダウンロード](/docs/api/fapi/me/exports/download) からダウンロードできます。

パッケージは ZIP ファイルで、データの種類ごとに 1 つの JSON ファイルが含まれます。プロフィール、メールアドレスと電話番号、連携済みのアイデンティティ、認証手段（シークレットは除く）、IP アドレスを含むセッション、組織のメンバーシップ、OAuth の付与、同意、サインインイベントです。パスワードのハッシュ、TOTP シード、リカバリーコード、トークン、`app_metadata` は決して含まれません。

最近のサインインが必要です。セッションが過去 5 分以内に検証されていない場合、またはユーザーが第二要素を持っていてセッションでそれを使用していない場合、応答は `401 step_up_required` となり、何も開始されません。ユーザーのエクスポートが準備中の場合は、そのエクスポートが返され、新しいエクスポートは開始されません。ユーザーが 24 時間以内に要求できるエクスポートは最大 2 件です。

## リクエスト

ヘッダー:

| ヘッダー | 必須 | 説明 |
| --- | --- | --- |
| `Idp-Client` | はい | SDK の識別子です。 |
| `Origin` | はい | 正確に `https://<サインインホスト>` である必要があります。 |

本文:

```json
{}
```

## レスポンス

`202 Accepted`:

```json
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
 "created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
```

## エラー

| ステータス | コード | 条件 |
| --- | --- | --- |
| 401 | `unauthenticated` | 有効なセッション Cookie がありません。 |
| 401 | `step_up_required` | サインインから 5 分以上経過している、または第二要素が必要です。`WWW-Authenticate` ヘッダーには `max_age=300`（第二要素が必要な場合は `acr_values` も）が含まれます。 |
| 403 | `origin_not_allowed` | `Origin` がないか、誤っています。 |
| 429 | `export_rate_limited` | 過去 24 時間に 2 件のエクスポートが既に要求されています。`Retry-After` の後に再試行してください。 |
| 429 | `rate_limited` | 環境内で準備中のエクスポートが多すぎます。`Retry-After` の後に再試行してください。 |
| 503 | `service_unavailable` | ユーザーディレクトリが一時的に利用できません。`Retry-After` の後に再試行してください。 |

## 例

```bash
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
  -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) では、保存される内容、保存期間、削除方法を説明しています。いずれのフィールドにも特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。
