アイデンティティの連携を解除
DELETE /fapi/v1/me/identities/{identity_id} · 環境のサインインホストから呼び出します
サインイン中のユーザーのアカウントから、ソーシャルまたはエンタープライズのアイデンティティの連携を解除します。ユーザーの最後のサインイン方法は削除できません。ユーザーの組織がこの連携で SSO を強制している場合、そのアイデンティティは顧客管理 API からのみ削除できます。削除に成功すると、ユーザーの認証済みのすべてのメールアドレスにセキュリティ通知が送信されます。ユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は、401 unauthenticated を返します。別のオリジンにある自社アプリは、代わりにフロント API のアクセストークン（DPoP 証明付きの Authorization: DPoP <token>。フロント API アクセストークン を参照）を送信できます。
セッションは過去 5 分以内に検証されている必要があります。ユーザーが第二要素を持っている場合、セッションも第二要素（urn:idp:acr:mfa）を使って開始されている必要があります。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子です。 |
Origin |
はい | 正確に https://<サインインホスト> である必要があります。 |
identity_id: 連携されたアイデンティティの idn_… 形式の識別子です。
本文はありません。
レスポンス
204 No Content。
エラー
| ステータス | コード | 条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
| 401 | step_up_required |
セッションが過去 5 分以内に検証されていない、または第二要素が必要です。WWW-Authenticate ヘッダーで max_age=300（該当する場合は acr_values）を指定して再検証してください。 |
| 403 | origin_not_allowed |
Origin がないか、誤っています。 |
| 404 | not_found |
このユーザーにそのアイデンティティはありません。 |
| 409 | last_login_method |
このアイデンティティはユーザーの最後のサインイン方法です。 |
| 409 | sso_enforced_by_organization |
ユーザーの組織がこの連携で SSO を強制しています。 |
例
curl -X DELETE https://example.keenauth.app/fapi/v1/me/identities/idn_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
個人データ
このエンドポイントは個人データを扱います：連携済みのアイデンティティ。KeenAuth API における個人データ では、保存される内容、保存期間、削除方法を説明しています。いずれのフィールドにも特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。