Saltar para o conteúdo principal
GET
Listar Sessões

Listar Sessões

GET /v1/agent-sessions Retorna uma lista paginada de sessões de agente para o inquilino autenticado. Os resultados podem ser filtrados por ID do agente e status da sessão. As sessões são retornadas em ordem cronológica inversa (as mais recentes primeiro).

Autenticação

Requer cabeçalho X-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.

Resposta

object[]
Array de objetos de sessão. Cada um contém 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, e updated_at. Os hashes dos tokens nunca são expostos nas respostas da lista.
integer
Contagem total de sessões que correspondem aos critérios de filtro, em todas as páginas.

Exemplo


Referência de Status da Sessão

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de consulta

agent_id
string<uuid>

Filtrar sessões por agente

status
enum<string>

Filtrar por estado da sessão

Opções disponíveis:
active,
terminated,
expired
limit
integer
padrão:25
Intervalo necessário: 1 <= x <= 100
offset
integer
padrão:0
Intervalo necessário: x >= 0

Resposta

Lista paginada de sessões

items
object[]
total
integer