List runs
list_runsThe recent runs of one workflow, newest first — how a lost run_id is found again.
Use this when the run_id run_workflow returned is no longer to hand, or to check whether one is still in flight before starting another. Returns run_id, status, step progress, credits and timestamps.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workflow_id": "<workflow_id>"
},
"name": "list_runs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many rows to return. Raise it only if the user asked for more. | |
| workflow_id | Yes | The workflow_id from list_workflows. Never invent one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runs | No | ||
| next_step | No | ||
| active_run_id | No |