관리자가 이메일 주소를 확인됨으로 표시

POST /v1/users/{user_id}/emails/{email_id}:verify · 권한 users:write

관리자의 권한으로 해당 주소를 확인됨으로 표시합니다. 사용자에게 코드나 링크가 전송되지 않으며, 확인 방법은 admin_api로 저장됩니다. 따라서 사용자가 해당 메일함을 실제로 소유한다는 증명이 되지 않습니다. 직접 주소를 확인하지 않은 경우에는 :send-verification을 사용하는 것이 좋습니다. 주소가 이미 확인되어 있으면 아무것도 기록되지 않고 200이 반환됩니다. 같은 환경의 다른 계정에 있는 같은 주소의 미확인 항목은 제거됩니다. 이 변경은 API 키를 행위자로 하여 관리 감사 로그에 user.email_verified로 기록되며, user.updated 이벤트를 발생시킵니다.

요청

매개변수	위치	필수	설명
`user_id`	경로	예	사용자 ID이며 접두사는 `usr_`입니다.
`email_id`	경로	예	이메일 행의 ID(내부 UUID, 소문자, 하이픈 포함)이며 `GET /v1/users/{user_id}/emails`가 반환한 값입니다.

요청 본문은 필요하지 않습니다(빈 본문 또는 {}를 허용합니다).

응답

업데이트된 이메일 행과 함께 200 OK가 반환됩니다. users:read_pii 권한이 없으면 주소는 마스킹됩니다(a***@e***.com).

{
  "id": "0191f0a0-3333-7444-8555-666666666666",
  "email": "ada@example.com",
  "verified": true,
  "primary": false,
  "created_at": "2026-01-15T09:30:00Z"
}

오류

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

HTTP	`code`	발생 조건
400	`malformed_request`, `unknown_field`	본문이 올바른 JSON이 아니거나, 비어 있지도 않고 `{}`도 아닙니다.
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/emails/0191f0a0-3333-7444-8555-666666666666:verify \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

개인 데이터

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