Obtener un trabajo de exportación de datos de usuarios

GET /v1/jobs/user-exports/{job_id} · permiso users:export

Devuelve un trabajo creado con Exportar los datos de un usuario.

status Significado
queued En espera de ejecución.
running Se está creando el paquete.
completed El paquete está listo; file tiene su tamaño y SHA-256. Descárguelo antes de expires_at.
failed No hay paquete; failure_reason es too_large, user_deleted, source_unavailable o attempts_exhausted.
expired El paquete se eliminó 7 días después de completarse. Inicie una nueva exportación.

Las exportaciones que los usuarios finales solicitan desde su propia página de cuenta no son visibles aquí.

Solicitud

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

Respuesta

200 OK.

{
  "id": "job_01j9xk3m7q8r2s4t6v8w0y2z4e",
  "kind": "subject",
  "source": "management_api",
  "user_id": "usr_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "status": "completed",
  "include_app_metadata": true,
  "include_ip": false,
  "file": {
    "size": 48213,
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
  },
  "failure_reason": null,
  "requested_by": { "type": "api_key", "id": "key_01j9xk3m7q8r2s4t6v8w0y2z4b" },
  "created_at": "2026-10-28T09:00:00Z",
  "started_at": "2026-10-28T09:00:02Z",
  "completed_at": "2026-10-28T09:00:09Z",
  "expires_at": "2026-11-04T09:00:09Z"
}

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 fue revocada.
403 insufficient_permissions La clave no tiene el permiso users:export.
404 not_found El trabajo no existe en este entorno (o el ID está mal formado).
429 rate_limited Se superó el límite de tasa; 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-exports/job_01j9xk3m7q8r2s4t6v8w0y2z4e \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth jobs user-exports get job_01j9xk3m7q8r2s4t6v8w0y2z4e