
# アイデンティティの連携を解除

`DELETE /fapi/v1/me/identities/{identity_id}` · 環境のサインインホストから呼び出します

サインイン中のユーザーのアカウントから、ソーシャルまたはエンタープライズのアイデンティティの連携を解除します。ユーザーの最後のサインイン方法は削除できません。ユーザーの組織がこの連携で SSO を強制している場合、そのアイデンティティは顧客管理 API からのみ削除できます。削除に成功すると、ユーザーの認証済みのすべてのメールアドレスにセキュリティ通知が送信されます。ユーザーの `__Host-idp_session` Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は、`401 unauthenticated` を返します。別のオリジンにある自社アプリは、代わりにフロント API のアクセストークン（DPoP 証明付きの `Authorization: DPoP <token>`。[フロント API アクセストークン](/docs/api/fapi/front-api-token) を参照）を送信できます。

セッションは過去 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 を強制しています。 |

## 例

```bash
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 における個人データ](/docs/policies/personal-data) では、保存される内容、保存期間、削除方法を説明しています。いずれのフィールドにも特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。
