Saltar al contenido principal
GET
Listar sesiones

Listar Sesiones

GET /v1/agent-sessions Devuelve una lista paginada de sesiones de agente para el inquilino autenticado. Los resultados se pueden filtrar por ID de agente y estado de la sesión. Las sesiones se devuelven en orden cronológico inverso (las más recientes primero).

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

object[]
Matriz de objetos de sesión. Cada uno contiene session_id, agent_id, status, scopes, metadata, expires_at, parent_session_id, handed_off_to, ip_address, user_agent, refreshed_at, terminated_at, created_at, y updated_at. Los hashes de los tokens nunca se exponen en las respuestas de lista.
integer
Recuento total de sesiones que coinciden con los criterios de filtro, en todas las páginas.

Ejemplo


Referencia de estado de sesión

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Parámetros de consulta

agent_id
string<uuid>

Filtrar sesiones por agente

status
enum<string>

Filtrar por estado de la sesión

Opciones disponibles:
active,
terminated,
expired
limit
integer
predeterminado:25
Rango requerido: 1 <= x <= 100
offset
integer
predeterminado:0
Rango requerido: x >= 0

Respuesta

Lista paginada de sesiones

items
object[]
total
integer