Execuções de workflow

As cadeias de requisições HTTP que os agentes devolveram em workflow, e o que cada destino respondeu. Duas ferramentas somente leitura — uma execução é criada por uma execução de agente, nunca por quem chama.

Veja o modelo WorkflowRun e Workflows do agente.

---

workflow_runs_list

Leitura · escopo inbox/workflow_runs · permissão workflow-runs.list · GET /workflow-runs

Lista as execuções de workflow. Paginação por cursor. Os passos não vêm embutidos — use workflow_runs_get.

Parâmetro	Tipo	Descrição
cursor	string	Cursor opaco de uma página anterior.
limit	integer	Tamanho da página, padrão 25, máximo 100.
sort	string	Chaves de ordenação, prefixo - para decrescente.
status	pending | running | success | failed	Filtra pelo status da execução.
email_id	string (uuid)	Só execuções produzidas a partir deste e-mail.
inbox_id	string (uuid)	Só execuções de mensagens recebidas nesta inbox.
agent_id	string (uuid)	Só execuções produzidas por este agente.
agent_run_id	string (uuid)	A execução do agente que produziu o workflow.
created_at_gte / created_at_lte	string	Intervalo ISO 8601 em created_at.
finished_at_gte / finished_at_lte	string	Intervalo ISO 8601 em finished_at.

workflow_runs_get

Leitura · escopo inbox/workflow_runs · permissão workflow-runs.show · GET /workflow-runs/{id}

Uma execução com todos os passos na ordem de execução: a requisição como enviada (valores de secrets substituídos por [REDACTED]), o status e o corpo da resposta, a duração e o erro de cada passo que falhou. Um passo que referencia outro que não teve sucesso fica skipped.

Parâmetro	Tipo	Descrição
id obrigatório	string (uuid)	Id da execução de workflow.