Skip to main content
GET
Uso del workspace
Tu token de API debe poder usar agentes (use_agents), y debes tener acceso al workspace: mismas capas que el resto de rutas de agentes y archivos (autenticación Sanctum, comprobación de acceso al workspace).

Ejemplos de código

Encabezados

integer
requerido
ID del workspace. Obligatorio a partir del 01/09/2026. Hasta entonces, si se omite, se usa el workspace seleccionado del usuario (deprecated). Después de la fecha, ausencia → 422.

Parámetros de consulta

string
Ventana relativa: 1d, 7d o 30d. Se ignora si se envían start_date y end_date. Si no se envía ninguna fecha, el valor efectivo por defecto es 30d.
date (YYYY-MM-DD)
Inicio del rango (inclusivo). Requerido con end_date.
date (YYYY-MM-DD)
Fin del rango (inclusivo). Debe ser >= start_date. Requerido con start_date. El rango no puede superar 90 días; si no, 422.
integer
Filtra por el usuario que ejecutó el agente. Sin permiso para ver la actividad de otros en el workspace, solo ves tus ejecuciones; filtrar por otro usuario devuelve 403.
string
Tipo de agente: all, chat, image, text, voiceover, video, code. all u omitido = sin filtro de tipo.
integer
Número de página. Predeterminado 1, mínimo 1.
integer
Tamaño de página. Predeterminado 20, entre 1 y 100.
Ventanas de fechas
  • Con start_date + end_date: el rango inclusivo tiene un máximo de 90 días.
  • Con range: la ventana es relativa al fin del día actual (1d = últimas 24 h desde ese instante; 7d / 30d = últimos 7 o 30 días naturales desde ese fin).
  • Si el flag usage_history_min_date está activo en la configuración, el inicio efectivo no será anterior a esa fecha (recorte silencioso).
Caché
  • El listado se guarda en caché unos 60 segundos por workspace, filtros y página. Las peticiones idénticas en ese intervalo pueden devolver el mismo cuerpo.

Respuesta

La paginación usa has_more: el servicio pide per_page + 1 filas; si existe la fila extra, has_more es true y solo las primeras per_page aparecen en items.

Campos de cada elemento

Errores

Los errores de validación usan el payload estándar de Laravel; algunos errores de workspace devuelven JSON { "message": "..." } con mensaje traducible.