Obtener la migración del rpId de una conexión

GET /v1/connections/{connection_id}/rp-id-migration · permiso connections:read

Devuelve la última migración de rpId de una conexión de clave de acceso, tanto si sigue en curso como si ya se cerró (consulte Cambiar el rpId de la clave de acceso). Los recuentos se registran cuando se cierra la migración y son null mientras está active. Las lecturas no se auditan.

Solicitud

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

Respuesta

200 OK:

{
  "id": "rpm_01j9xr4a6b8c0d2e4f6g8h0j2k",
  "connection_id": "conn_01j9xp6q0r1s5t7v9w1x3y5z7b",
  "previous_rp_id": null,
  "new_rp_id": "login.example.com",
  "status": "completed_early",
  "started_at": "2026-10-27T10:00:00Z",
  "ends_at": "2027-01-25T10:00:00Z",
  "completed_at": "2026-12-01T09:00:00Z",
  "revoked_count": 12,
  "new_registration_count": 340,
  "fallback_enabled_by_migration": false
}

Campo	Descripción
`status`	`active`, `completed` (la ventana terminó) o `completed_early`.
`revoked_count`	Claves de acceso del rpId anterior que se revocaron al cerrarse la migración.
`new_registration_count`	Claves de acceso registradas en el nuevo rpId durante la ventana.

Errores

HTTP	code	Cuándo
404	`not_found`	La conexión no existe en este entorno, no es una conexión de clave de acceso o nunca ha tenido una migración de rpId.
401	`unauthenticated`	La credencial falta, no es válida o ha sido revocada.
403	`insufficient_permissions`	La credencial no tiene el permiso necesario.
429	`rate_limited`	Se superó el límite de tasa; reintente después del período indicado en `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintente después del período indicado en `Retry-After`.

Ejemplo

curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/rp-id-migration" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections rp-id-migration conn_01j9xp6q0r1s5t7v9w1x3y5z7b