일괄 비밀번호 재설정 작업 조회

GET /v1/jobs/password-resets/{job_id} · 권한 user-credentials:write

일괄 비밀번호 재설정 작업 생성으로 만든 작업의 상태와 카운터를 반환합니다. 개인 데이터는 반환되지 않습니다. status는 다음 순서로 진행합니다.

marking: 선택된 비밀번호를 표시하는 중입니다. marked가 늘어납니다.
waiting: lazy_then_bulk_reset 전용입니다. 표시가 끝났고(marked_at) 작업은 deadline_at을 기다립니다.
resetting: lazy_then_bulk_reset 전용입니다. 기한이 지났으며, 아직 비밀번호를 바꾸지 않은 사용자의 비밀번호를 삭제하는 중입니다(passwords_deleted). 확인된 기본 주소가 있는 사용자에게는 재설정 이메일을 보냅니다(emailed).
completed: 작업이 끝났습니다(completed_at). on_login 작업은 표시가 끝나는 즉시 완료됩니다.

total은 user_ids 작업에서 서로 다른 사용자 수이며, hash_algo 작업에서는 0입니다. not_found는 이 환경의 사용자가 아니거나 비밀번호가 없는 ID의 수입니다.

요청

매개변수	위치	필수	설명
`job_id`	path	예	`job_` 접두사가 붙은 작업 ID입니다.

응답

200 OK.

{
  "id": "job_01h455vb4pex5vsknk084sn02q",
  "mode": "on_login",
  "filter": "user_ids",
  "status": "completed",
  "total": 3,
  "marked": 2,
  "not_found": 1,
  "passwords_deleted": 0,
  "emailed": 0,
  "created_at": "2026-01-15T09:30:00Z",
  "marked_at": "2026-01-15T09:31:00Z",
  "completed_at": "2026-01-15T09:31:00Z"
}

오류

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

HTTP	`code`	발생 시점
401	`unauthenticated`	API 키가 없거나, 잘못되었거나, 취소되었습니다.
403	`insufficient_permissions`	키에 `user-credentials:write` 권한이 없습니다.
404	`not_found`	이 환경에 해당 작업이 없습니다(또는 ID 형식이 잘못되었습니다).
429	`rate_limited`	요청 한도를 초과했습니다. `Retry-After` 값을 따르십시오.
503	`service_unavailable`	종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오.

예제

curl https://api.eu.keenauth.com/v1/jobs/password-resets/job_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth jobs password-resets get job_01h455vb4pex5vsknk084sn02q