一括ユーザー削除ジョブを取得する

GET /v1/jobs/user-deletions/{job_id} · 権限 users:delete

一括ユーザー削除ジョブを作成する で作成したジョブの状態とカウンターを返します。すべてのユーザーに結果が出るまでジョブは running で、その後は completed(失敗なし)または completed_with_errors(failed が1件以上)になります。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