Execution

Execute workflows and monitor active executions

Execute Workflow Endpoint

POST
/workflows/{workflow_id}/execute

Path Parameters

workflow_id*string

Request Body

application/json

inputs?

Input variables for the workflow.

task?|

Primary task description -- substituted for $ARGUMENTS in phase prompts.

provider?stringDeprecated

Agent provider to use. Currently ignored by execute(); sending this field has no effect.

Default"claude"
max_budget_usd?|Deprecated

Maximum budget in USD. Currently ignored by execute(); sending this field has no effect.

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/workflows/string/execute" \  -H "Content-Type: application/json" \  -d '{}'
{
  "execution_id": "string",
  "workflow_id": "string",
  "status": "started",
  "message": "Workflow execution started"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Execution Status Endpoint

GET
/workflows/{workflow_id}/executions/{execution_id}

Path Parameters

workflow_id*string
execution_id*string

Response Body

application/json

application/json

curl -X GET "https://loading/workflows/string/executions/string"
{
  "execution_id": "string",
  "workflow_id": "string",
  "status": "string",
  "current_phase": "string",
  "completed_phases": 0,
  "total_phases": 0,
  "started_at": "string",
  "completed_at": "string",
  "error": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

List Active Executions Endpoint

GET
/workflows/executions/active

Query Parameters

limit?integer
Default20
Range1 <= value <= 100

Response Body

application/json

application/json

curl -X GET "https://loading/workflows/executions/active"
[
  {
    "execution_id": "string",
    "workflow_id": "string",
    "status": "string",
    "current_phase": "string",
    "completed_phases": 0,
    "total_phases": 0,
    "started_at": "string",
    "completed_at": "string",
    "error": "string"
  }
]
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Syntropic137 Docs v0.18.0 · Last updated March 2026

On this page