Ejecuciones de workflow

Las cadenas de peticiones HTTP que los agentes devolvieron en workflow, y qué respondió cada destino. Dos herramientas de solo lectura — una ejecución la crea una ejecución de agente, nunca quien llama.

Vea el modelo WorkflowRun y Workflows del agente.

---

workflow_runs_list

Lectura · scope inbox/workflow_runs · permiso workflow-runs.list · GET /workflow-runs

Lista las ejecuciones de workflow. Paginación por cursor. Los pasos no vienen incluidos — use workflow_runs_get.

Parámetro	Tipo	Descripción
cursor	string	Cursor opaco de una página anterior.
limit	integer	Tamaño de página, por defecto 25, máximo 100.
sort	string	Claves de orden, prefijo - para descendente.
status	pending | running | success | failed	Filtra por el status de la ejecución.
email_id	string (uuid)	Solo ejecuciones producidas a partir de este correo.
inbox_id	string (uuid)	Solo ejecuciones de mensajes recibidos en este inbox.
agent_id	string (uuid)	Solo ejecuciones producidas por este agente.
agent_run_id	string (uuid)	La ejecución de agente que produjo el workflow.
created_at_gte / created_at_lte	string	Rango ISO 8601 sobre created_at.
finished_at_gte / finished_at_lte	string	Rango ISO 8601 sobre finished_at.

workflow_runs_get

Lectura · scope inbox/workflow_runs · permiso workflow-runs.show · GET /workflow-runs/{id}

Una ejecución con todos sus pasos en orden: la petición tal como se envió (valores de secrets reemplazados por [REDACTED]), el status y el cuerpo de la respuesta, la duración y el error de cada paso que falló. Un paso que referencia a otro que no tuvo éxito queda skipped.

Parámetro	Tipo	Descripción
id obligatorio	string (uuid)	Id de la ejecución de workflow.