Workflow runs
The chains of HTTP requests agents returned under workflow, and what each destination answered. Two read-only tools — a run is created by an agent run, never by a caller.
See the WorkflowRun model and Agent workflows.
workflow_runs_list
Read · scope
inbox/workflow_runs· permissionworkflow-runs.list·GET /workflow-runs
List workflow runs. Cursor-paginated. Steps are not embedded — use workflow_runs_get.
| Parameter | Type | Description |
|---|---|---|
cursor | string | Opaque cursor from a previous page. |
limit | integer | Page size, default 25, max 100. |
sort | string | Sort keys, - prefix for descending. |
status | pending | running | success | failed | Filter by run status. |
email_id | string (uuid) | Only runs produced from this e-mail. |
inbox_id | string (uuid) | Only runs of mail received on this inbox. |
agent_id | string (uuid) | Only runs produced by this agent. |
agent_run_id | string (uuid) | The agent execution that produced the workflow. |
created_at_gte / created_at_lte | string | ISO 8601 range on created_at. |
finished_at_gte / finished_at_lte | string | ISO 8601 range on finished_at. |
workflow_runs_get
Read · scope
inbox/workflow_runs· permissionworkflow-runs.show·GET /workflow-runs/{id}
One run with every step in execution order: the request as sent (secret values replaced by [REDACTED]), the response status and body, the duration, and the error of each step that failed. A step that references one that did not succeed is skipped.
| Parameter | Type | Description |
|---|---|---|
id required | string (uuid) | Workflow run id. |