Skip to main content
GET
Uso do workspace
Seu token de API precisa poder usar agentes (use_agents), e você precisa ter acesso ao workspace—mesmas camadas dos outros endpoints de agentes e arquivos (autenticação Sanctum, checagem de acesso ao workspace).

Exemplos de código

Cabeçalhos

integer
obrigatório
ID do workspace. Obrigatório a partir de 01/09/2026. Até lá, se omitido, usa o workspace selecionado do usuário (deprecated). Após a data, ausência → 422.

Parâmetros de consulta

string
Janela relativa: 1d, 7d ou 30d. Ignorado se start_date e end_date forem enviados. Se nenhum parâmetro de data for enviado, o padrão efetivo é 30d.
date (AAAA-MM-DD)
Início do intervalo (inclusivo). Obrigatório com end_date.
date (AAAA-MM-DD)
Fim do intervalo (inclusivo). Deve ser >= start_date. Obrigatório com start_date. O intervalo não pode ultrapassar 90 dias; senão 422.
integer
Filtra pelo usuário que executou o agente. Sem permissão de leitura de atividade de outros no workspace, você vê só suas execuções; filtrar por outro usuário retorna 403.
string
Tipo de agente: all, chat, image, text, voiceover, video, code. all ou omitido = sem filtro de tipo.
integer
Número da página. Padrão 1, mínimo 1.
integer
Tamanho da página. Padrão 20, entre 1 e 100.
Janelas de data
  • Com start_date + end_date: o intervalo inclusivo tem teto de 90 dias.
  • Com range: a janela é relativa ao fim do dia atual (1d = últimas 24 h a partir desse instante; 7d / 30d = últimos 7 ou 30 dias corridos a partir desse fim).
  • Se o recurso usage_history_min_date estiver habilitado nas configurações, o início efetivo não fica antes dessa data (ajuste silencioso).
Cache
  • A listagem fica em cache por cerca de 60 segundos por workspace, filtros e página. Requisições idênticas nesse intervalo podem retornar o mesmo corpo.

Resposta

A paginação usa has_more: o serviço busca per_page + 1 linhas; se a linha extra existir, has_more é true e só as primeiras per_page entram em items.

Campos de cada item

Erros

Erros de validação seguem o payload padrão do Laravel; alguns erros de workspace retornam JSON { "message": "..." } com mensagem traduzível.