사용자 삭제 취소

POST /v1/users/{user_id}:cancel-deletion · 권한 users:write

유예 기간이 아직 남아 있는 사용자 삭제(셀프 서비스 삭제)를 취소합니다. 사용자는 다시 active가 되며, 아직 유효한 차단이 있으면 blocked가 됩니다. 사용자가 삭제 대기 중이 아니면 호출은 아무것도 변경하지 않고 사용자를 반환합니다. 이 요청은 본문을 받지 않습니다.

요청

매개변수	위치	필수	설명
`user_id`	경로	예	사용자 ID이며 `usr_` 접두사가 붙습니다.

응답

200 OK. 본문은 사용자 객체입니다. ETag 헤더에는 사용자 버전이 담깁니다.

키에 users:read_pii 권한이 없으면 개인정보가 마스킹됩니다: email은 a***@e***.com이 되고, phone_number는 마지막 2자리만 남습니다(+**********67). name, given_name, family_name, middle_name, nickname은 이니셜(A. L.)이 되며, username은 첫 글자만 남습니다(a***). birthdate는 ****-**-**이 되고 address는 {"redacted": true}가 됩니다. user_metadata와 app_metadata는 마스킹되지 않습니다.

{
  "id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "kind": "regular",
  "status": "active",
  "external_id": null,
  "username": null,
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "email_verified": true,
  "phone_number": null,
  "phone_verified": false,
  "user_metadata": {},
  "app_metadata": {},
  "created_via": "admin_api",
  "created_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z",
  "last_sign_in_at": null,
  "deletion_requested_at": null,
  "deletion_due_at": null
}

오류

모든 오류는 안정적인 code를 포함한 application/problem+json 본문입니다.

HTTP	`code`	발생 시점
409	`conflict`	유예 기간이 끝나 삭제가 진행 중이므로 더 이상 취소할 수 없습니다(`errors[].code`는 `deletion_due`).
404	`not_found`	이 환경에 사용자가 없거나 ID 형식이 잘못되었습니다.
401	`unauthenticated`	API 키가 없거나 잘못되었거나 폐기되었습니다.
403	`insufficient_permissions`	키에 `users:write` 권한이 없습니다.
429	`rate_limited`	요청 한도를 초과했습니다. `Retry-After`를 따르십시오.
503	`service_unavailable`	종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오.

예제

curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p:cancel-deletion \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

개인정보

이 엔드포인트는 개인정보를 포함합니다: 최종 사용자 프로필. KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.