# 사용자에게서 연결된 ID 제거

`DELETE /v1/users/{user_id}/identities/{identity_id}` · 권한 `users:write`

사용자의 연결된 ID 하나(비밀번호, 소셜, SAML, OIDC 또는 레거시)를 제거합니다. 사용자가 속한 조직이 해당 ID의 연결을 통해 Single Sign-On을 강제하더라도 제거는 진행됩니다. 사용자는 계정 포털에서 이런 ID를 제거할 수 없으므로(`409 sso_enforced_by_organization`), 고객이 이 엔드포인트로 제거해야 합니다. 사용자의 마지막 1차 인증 방식은 제거할 수 없습니다(`409 last_login_method`). 확인된 모든 이메일 주소로 사용자에게 알림이 전송되며, 작업은 API 키를 행위자로 하여 관리 감사 로그에 기록됩니다.

## 요청

| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
| `user_id` | 경로 | 예 | 사용자 ID이며 접두사는 `usr_`입니다. |
| `identity_id` | 경로 | 예 | ID의 식별자이며 접두사는 `idn_`입니다(`GET /v1/users/{user_id}/identities`가 반환한 값). |

요청 본문은 필요하지 않습니다.

## 응답

`204 No Content`.

## 오류

모든 오류는 안정적인 `code`를 포함한 `application/problem+json` 본문으로 반환됩니다.

| HTTP | `code` | 발생 조건 |
|---|---|---|
| 404 | `not_found` | 이 환경에 사용자가 없거나, ID가 이 사용자에게 속하지 않거나 알 수 없거나, ID 형식이 잘못되었습니다. |
| 409 | `last_login_method` | 이 ID는 사용자의 마지막 1차 인증 방식입니다. 먼저 다른 방식을 추가하십시오. |
| 401 | `unauthenticated` | API 키가 없거나, 잘못되었거나, 취소되었습니다. |
| 403 | `insufficient_permissions` | 키에 `users:write` 권한이 없습니다. |
| 429 | `rate_limited` | 요청 한도를 초과했습니다. `Retry-After`를 준수하십시오. |
| 503 | `service_unavailable` | 종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |

## 예시

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities/idn_0a1b2c3d4e5f6g7h8j9k0m1n2r \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## 개인 데이터

이 엔드포인트는 개인 데이터를 포함합니다: 연결된 ID. [KeenAuth API의 개인 데이터](/docs/policies/personal-data)에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특별 범주의 개인 데이터(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.