Uso del workspace
Workspaces
Uso del workspace
Lista el historial de ejecuciones de agentes de un workspace con filtros, paginación y campos enriquecidos.
GET
Uso del workspace
Tu token de API debe poder usar agentes (
Ventanas de fechas
La paginación usa
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.
- 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_dateestá activo en la configuración, el inicio efectivo no será anterior a esa fecha (recorte silencioso).
- 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
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.