Uso do workspace
Workspaces
Uso do workspace
Liste o histórico de execuções de agentes de um workspace com filtros, paginação e campos enriquecidos.
GET
Uso do workspace
Seu token de API precisa poder usar agentes (
Janelas de data
A paginação usa
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.
- 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_dateestiver habilitado nas configurações, o início efetivo não fica antes dessa data (ajuste silencioso).
- 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
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.