GET /v1/runs/{id}
/v1/runs/{id}
Path Parameters
id
string
required
path
Query Parameters
summary
boolean
optional
query
nodeIds
string
optional
query
Responses
application/jsoncode
integer
data
object
executionState
object
finishedAt
string
id
string
isDustTest
boolean
isSimulation
boolean
organizationId
string
propValues
object
simulationForks
object[]
chainId
integer
forkId
string
rpcUrl
string
simulationMode
string
sourceRunId
string
startedAt
string
status
string
running waiting success partial failure cancelledsummary
string
totalCu
number
triggerNodeId
string
triggerSource
string
triggeredBy
string
workflowDefinition
object
blockExpansions
object
inputSchema
object[]
description
string
key
string
required
boolean
type
string
nodes
object
REQUIRED
sensitivePropKeys
string[]
triggerNodeIds
string[]
TriggerNodeIDs lists the node IDs that are trigger (root) nodes. Every workflow declares this — single-trigger workflows ship ["root"] (the legacy node id), multi-trigger workflows list every trigger node id. Treating single-trigger as a forest-of-1 removes the two-path branching throughout the BE + FE; older rows without the field are backfilled by migration 000282 and the field-missing path stays as a read-side safety net (see FindTriggerNodeIDs) but is no longer exercised by saves.
"root" is also a runtime alias for "the trigger that fired this run" — {{root.X}} variable references resolve to the firing trigger regardless of which trigger fired. Don't repurpose the literal "root" as a trigger id on a multi-trigger workflow.
variableDefs
object[]
default
unknown
description
string
lifetime
string
persist resetname
string
type
string
number text boolean list objectworkflowId
string
workflowOwnerUserId
string
workflowVersion
integer
message
string
requestId
string
curl -X GET 'https://api.example.com/v1/runs/string' \ -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://api.example.com/v1/runs/string', { method: 'GET', headers: { "Authorization": "Bearer YOUR_API_TOKEN" }});const data = await response.json();console.log(data);
import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://api.example.com/v1/runs/string', headers=headers)print(response.json())
package mainimport ( "fmt" "io" "net/http")func main() { req, _ := http.NewRequest("GET", "https://api.example.com/v1/runs/string", nil) req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() result, _ := io.ReadAll(resp.Body) fmt.Println(string(result))}
{ "code": 200, "data": { "executionState": "<object>", "finishedAt": "<string>", "id": "<string>", "isDustTest": true, "isSimulation": true, "organizationId": "<string>", "propValues": "<object>", "simulationForks": [ { "chainId": 123, "forkId": "<string>", "rpcUrl": "<string>" } ], "simulationMode": "<string>", "sourceRunId": "<string>", "startedAt": "<string>", "status": "running", "summary": "<string>", "totalCu": 123, "triggerNodeId": "<string>", "triggerSource": "<string>", "triggeredBy": "<string>", "workflowDefinition": { "blockExpansions": "<object>", "inputSchema": [ { "description": "<string>", "key": "<string>", "required": true, "type": "<string>" } ], "nodes": "<object>", "sensitivePropKeys": [ "<string>" ], "triggerNodeIds": [ "<string>" ], "variableDefs": [ { "default": "<unknown>", "description": "<string>", "lifetime": "persist", "name": "<string>", "type": "number" } ] }, "workflowId": "<string>", "workflowOwnerUserId": "<string>", "workflowVersion": 123 }, "message": "success", "requestId": "abc-123"}
Try this endpoint
/v1/runs/{id}
