メールアドレスを削除
DELETE /fapi/v1/me/emails/{email_id} · 環境のサインインホストから呼び出します
認証済みユーザーのメールアドレスを 1 つ削除します。プライマリアドレスは削除できません。先に別の確認済みアドレスをプライマリに設定してください。環境でメールアドレスが必須になっている場合、ユーザーの最後の確認済みアドレスも削除できません。__Host-idp_session Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は 401 unauthenticated を返します。別オリジンのファーストパーティアプリでは、代わりにフロント API アクセストークン（DPoP 証明付きの Authorization: DPoP <token>）を送信できます。詳細は フロント API アクセストークン を参照してください。
セッションは直近 5 分以内に検証されている必要があります。ユーザーに第 2 要素がある場合は、セッションが第 2 要素（urn:idp:acr:mfa）を使って開始されている必要もあります。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子。 |
Origin |
はい | 正確に https://<sign-in host> である必要があります。 |
email_id: GET /fapi/v1/me/emails が返すメールアドレス識別子（小文字の UUID）。
ボディはありません。
レスポンス
204 No Content。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
| 401 | step_up_required |
セッションが直近 5 分以内に検証されていないか、第 2 要素が必要です。WWW-Authenticate ヘッダーで max_age=300（該当する場合は acr_values）を指定して再認証してください。 |
| 403 | origin_not_allowed |
Origin がないか、誤っています。 |
| 404 | not_found |
このユーザーにそのメールアドレスは存在しません。 |
| 409 | primary_identifier_required |
そのアドレスはプライマリです。 |
| 409 | last_verified_channel |
そのアドレスはユーザーの最後の確認済みアドレスで、環境ではメールアドレスが必須です。 |
例
curl -X DELETE https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
個人データ
このエンドポイントは個人データを扱います: エンドユーザーのプロフィール。KeenAuth API における個人データ で、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも、特別カテゴリの個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。