Execution
Execute workflows and monitor active executions
Execute Workflow Endpoint
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.
repos?array<>
GitHub URLs or 'owner/repo' slugs to pre-clone for workspace hydration (ADR-058, ADR-063). Typed channel for repository identity: one execution can touch 0, 1, or N repos. Passing 'repository' or 'repos' in the inputs dict is rejected with 422.
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",
"input": null,
"ctx": {}
}
]
}Get Execution Status Endpoint
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",
"input": null,
"ctx": {}
}
]
}List Active Executions Endpoint
Query Parameters
limit?integer
Default
20Range
1 <= value <= 100Response 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",
"input": null,
"ctx": {}
}
]
}Syntropic137 Docs v0.25.4 · Last updated March 2026