Skip to main content
POST
/
api
/
v1
/
workflows
/
{workflowId}
/
runs
/
async
curl -X POST https://api.origamiagents.com/api/v1/workflows/wf_abc123/runs/async \
  -H "x-origami-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": {
      "node_xyz": {
        "config": {
          "prompt": "Custom prompt text"
        }
      }
    }
  }'

{
  "success": true,
  "data": {
    "workflowId": "wf_abc123",
    "runId": "run_xyz789",
    "status": "queued"
  }
}

​
Trigger Async Run

Starts a new workflow run asynchronously. The run is queued and executed in the background. Use the status and response endpoints to monitor progress and retrieve results.

​
Path Parameters

​
workflowId
string
required
The unique identifier of the workflow to run

​
Request Body

​
nodes
object
required
Configuration overrides for nodes in the workflow. Use an empty object {} to run with default configurations.

​
Response

​
success
boolean
Whether the request was successful
​
data
object
curl -X POST https://api.origamiagents.com/api/v1/workflows/wf_abc123/runs/async \
  -H "x-origami-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": {
      "node_xyz": {
        "config": {
          "prompt": "Custom prompt text"
        }
      }
    }
  }'

{
  "success": true,
  "data": {
    "workflowId": "wf_abc123",
    "runId": "run_xyz789",
    "status": "queued"
  }
}