一括ユーザー削除ジョブを取得する
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