Obtener el último resultado de prueba de una conexión

GET /v1/connections/{connection_id}/test-results/latest · permiso connections:write

Devuelve el resultado del inicio de sesión de prueba más reciente de una conexión empresarial de las últimas 24 horas: estado, motivo del fallo, los nombres de los atributos o claims que envió el proveedor de identidad, el número de grupos y los campos de usuario que recibieron un valor mediante la asignación de atributos. Los valores de los atributos, la aserción SAML sin procesar y el ID token nunca se guardan ni se devuelven. Los resultados de prueba se conservan 24 horas. Las lecturas no se auditan.

Solicitud

Campo	Tipo	Obligatorio	Descripción
`connection_id`	ruta	sí	ID de la conexión empresarial (`conn_…`).

Respuesta

200 OK:

{
  "test_id": "conntest_01j9xr4a6b8c0d2e4f6g8h0j2k",
  "status": "passed",
  "failure_reason": null,
  "attribute_names": ["email", "given_name", "groups"],
  "group_count": 2,
  "mapped_fields": ["email", "given_name"],
  "started_at": "2026-10-20T10:00:00Z",
  "completed_at": "2026-10-20T10:01:12Z"
}

Campo	Descripción
`status`	`pending` (la URL aún no se abrió o el proveedor de identidad aún no ha respondido), `passed` o `failed`.
`failure_reason`	Motivo legible por máquina de una prueba fallida (por ejemplo `configuration_changed` cuando la conexión se cambió durante la prueba); en otro caso, `null`.
`attribute_names`	Nombres de los atributos o claims que envió el proveedor de identidad (no sus valores).
`group_count`	Número de grupos recibidos.
`mapped_fields`	Campos de usuario que recibieron un valor mediante la asignación de atributos (no los valores).
`started_at`, `completed_at`	Cuándo empezó la prueba y cuándo se procesó la respuesta del proveedor de identidad; `completed_at` es `null` mientras está `pending`.

Errores

HTTP	code	Cuándo
404	`not_found`	La conexión no existe en este entorno, no es una conexión empresarial o no tiene un resultado de prueba de las últimas 24 horas.
401	`unauthenticated`	La credencial falta, no es válida o está revocada.
403	`insufficient_permissions`	La credencial no tiene el permiso necesario.
429	`rate_limited`	Se superó el límite de solicitudes; reintenta tras el periodo indicado en `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintenta tras el periodo indicado en `Retry-After`.

Ejemplo

curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/test-results/latest" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections test-results latest conn_01j9xp6q0r1s5t7v9w1x3y5z7b