# パスワードを変更する

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

サインイン中のユーザーのパスワードを変更します。現在のパスワードが確認されます。新しいパスワードは、環境のパスワードポリシー、漏えいパスワードチェック、パスワード履歴ルールに適合している必要があります。成功すると、ユーザーの他のすべてのセッションとリフレッシュトークンが取り消され、このセッションはサインインしたままになります。また、ユーザーのメールアドレスにセキュリティ通知が送信されます。認証済みユーザーの `__Host-idp_session` Cookie が必要です。別オリジンの自社アプリケーションは、代わりにフロント API アクセストークン(DPoP 証明付きの `Authorization: DPoP <token>`。[フロント API アクセストークン](/docs/api/fapi/front-api-token) を参照)を送信できます。

## リクエスト

ヘッダー:

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

本文:

```json
{"current_password": "…", "new_password": "…"}
```

## レスポンス

`204 No Content`。

## エラー

| ステータス | コード | 発生条件 |
| --- | --- | --- |
| 401 | `unauthenticated` | 有効なセッション Cookie がありません。 |
| 401 | `step_up_required` | セッションが直近 5 分以内に検証されていません。`WWW-Authenticate` ヘッダーの `max_age=300` で再検証してください。何も確認もカウントもされません。 |
| 401 | `invalid_credentials` | 現在のパスワードが誤っています。失敗が繰り返されると、サインインと同じ方法でパスワードがロックされます。 |
| 403 | `origin_not_allowed` | `Origin` がない、または誤っています。 |
| 422 | `password_policy_violation` | 新しいパスワードがポリシーに違反しています。`errors[]` には `/new_password` について違反したルールが一覧されます(`too_short`、`too_long`、`context_term`、`custom_term`、`repeated_chars`、`invalid_text`、`reused`)。 |
| 422 | `breached_password` | 新しいパスワードが既知のデータ漏えいに含まれています。 |
| 503 | `temporarily_unavailable` | サーバーが混雑しています。`Retry-After` 秒後に再試行してください。 |

## 例

```bash
curl -X POST https://example.keenauth.app/fapi/v1/me/password \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/json" \
  -d '{"current_password": "…", "new_password": "…"}' \
  -b cookies.txt
```

## 個人データ

このエンドポイントは個人データ(認証情報)を扱います。[KeenAuth API における個人データ](/docs/policies/personal-data) では、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。