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 '{
    "rows": [
      { "name": "Alice", "email": "alice@example.com" },
      { "name": "Bob", "email": "bob@example.com" }
    ]
  }'

{
  "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

​
rows
array
required
An array of JSON objects representing the input data for the workflow. Each object in the array will be processed as a row by the workflow’s input node.

​
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 '{
    "rows": [
      { "name": "Alice", "email": "alice@example.com" },
      { "name": "Bob", "email": "bob@example.com" }
    ]
  }'

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