사용자 삭제
DELETE /v1/users/{user_id} · 권한 users:delete
사용자 삭제를 시작합니다. 사용자는 즉시 pending_deletion 상태가 되며, 삭제 예정 시점은 지금으로 설정됩니다. 이후 영구 삭제는 비동기로 실행됩니다. 응답은 deletion_id가 포함된 202 Accepted입니다. 같은 사용자에 대해 요청을 반복하면 동일한 deletion_id가 반환됩니다. 이 엔드포인트에는 취소 가능 기간이 없습니다.
요청
| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
user_id |
path | 예 | 사용자 ID이며 접두사는 usr_입니다. |
응답
202 Accepted입니다.
{
"deletion_id": "0191f0a0-0000-8000-8000-000000000001",
"requested_at": "2026-01-15T09:30:00Z"
}
오류
모든 오류는 안정적인 code를 포함한 application/problem+json 본문입니다.
| HTTP | code |
발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 사용자가 없거나 ID 형식이 잘못되었습니다. |
| 401 | unauthenticated |
API 키가 없거나, 잘못되었거나, 취소되었습니다. |
| 403 | insufficient_permissions |
키에 users:delete 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After를 따르십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |
예시
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
개인 정보
이 엔드포인트는 개인 정보(최종 사용자 프로필)를 처리합니다. KeenAuth API의 개인 정보에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특수 범주의 개인 정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.