일괄 사용자 삭제 작업 조회

GET /v1/jobs/user-deletions/{job_id} · 권한 users:delete

일괄 사용자 삭제 작업 생성으로 만든 작업의 상태와 카운터를 반환합니다. 모든 사용자가 결과를 가질 때까지 작업은 running이며, 그 뒤에는 completed(실패 없음) 또는 completed_with_errors(failed가 하나 이상)가 됩니다. pending은 아직 결과가 없는 사용자 수이며, succeeded + not_found + failed + pending = total이 항상 성립합니다. 중단된 작업(예: 재시작으로 인해)은 스스로 계속 진행됩니다. status가 running이 아닐 때까지 이 엔드포인트를 조회하십시오.

요청

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

응답

200 OK.

{
  "id": "job_01h455vb4pex5vsknk084sn02q",
  "status": "completed_with_errors",
  "filter": "organization",
  "organization_id": "org_01h455vb4pex5vsknk084sn02q",
  "total": 3,
  "succeeded": 1,
  "not_found": 1,
  "failed": 1,
  "pending": 0,
  "created_at": "2026-01-15T09:30:00Z",
  "completed_at": "2026-01-15T09:31:00Z"
}

오류

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

HTTP	`code`	언제
401	`unauthenticated`	API 키가 없거나 잘못되었거나 폐기되었습니다.
403	`insufficient_permissions`	키에 `users:delete` 권한이 없습니다.
404	`not_found`	이 환경에 작업이 없습니다(또는 ID 형식이 잘못되었습니다).
429	`rate_limited`	요청 한도를 초과했습니다. `Retry-After`를 따르십시오.
503	`service_unavailable`	의존 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오.

예제

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

CLI: keenauth jobs user-deletions get job_01h455vb4pex5vsknk084sn02q