Obtener un trabajo de eliminación masiva de usuarios

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

Devuelve el estado y los contadores de un trabajo creado con Crear un trabajo de eliminación masiva de usuarios. El trabajo está en running hasta que cada usuario tiene un resultado; después pasa a completed (sin fallos) o completed_with_errors (al menos un failed). pending es el número de usuarios que todavía no tienen resultado; succeeded + not_found + failed + pending = total. Un trabajo interrumpido (por ejemplo, por un reinicio) continúa por sí solo; consulte este endpoint hasta que status deje de ser running.

Solicitud

Parámetro	En	Obligatorio	Descripción
`job_id`	path	sí	Id del trabajo, con prefijo `job_`.

Respuesta

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"
}

Errores

Cada error es un cuerpo application/problem+json con un code estable.

HTTP	`code`	Cuándo
401	`unauthenticated`	La clave de API falta, no es válida o está revocada.
403	`insufficient_permissions`	La clave no tiene el permiso `users:delete`.
404	`not_found`	El trabajo no existe en este entorno (o el id tiene un formato incorrecto).
429	`rate_limited`	Se superó el límite de frecuencia; respete `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintente más tarde.

Ejemplo

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