POST /v1/runs/sync

Execute a workflow definition synchronously. Blocks until all nodes complete and returns the full execution state. Max 60s timeout, 20 nodes.

POST /v1/runs/sync
Execute a workflow definition synchronously. Blocks until all nodes complete and returns the full execution state. Max 60s timeout, 20 nodes.

Request Body required

Workflow definition to execute

application/json
One of:
Option 1
Option 2
definition object REQUIRED
Definition is the full workflow graph to execute. Must contain a "root" node with type "manual". All action nodes referenced in children arrays must be present.
blockExpansions object
Set on run snapshots only (not workflow DB)
inputSchema object[]
Array of:
description string
key string
required boolean
type string
"string", "number", "boolean", "object", "array"
nodes object REQUIRED
sensitivePropKeys string[]
Legacy: kept for old runs; no longer populated for new workflows
Array of:
payload object
propValues object

Responses

200 OK
application/json
durationMs integer
executionState object
runId string
status string
400 Bad Request
402 Payment Required 
curl -X POST 'https://api.example.com/v1/runs/sync' \  -H 'Authorization: Bearer YOUR_API_TOKEN' \  -H 'Content-Type: application/json' \  -d '{}'
const response = await fetch('https://api.example.com/v1/runs/sync', {  method: 'POST',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN",      "Content-Type": "application/json"  },  body: JSON.stringify({})});const data = await response.json();console.log(data);
import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.post('https://api.example.com/v1/runs/sync', headers=headers, json={})print(response.json())
package mainimport (	"fmt"	"io"	"net/http"	"strings")func main() {	body := strings.NewReader(`{}`)	req, _ := http.NewRequest("POST", "https://api.example.com/v1/runs/sync", body)	req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")	req.Header.Set("Content-Type", "application/json")	resp, _ := http.DefaultClient.Do(req)	defer resp.Body.Close()	result, _ := io.ReadAll(resp.Body)	fmt.Println(string(result))}
200 Response 
{  "durationMs": 123,  "executionState": "<object>",  "runId": "<string>",  "status": "<string>"}
Previous Retry outbound webhook delivery
Next Batch run transaction attribution