> ## Documentation Index
> Fetch the complete documentation index at: https://docs.origamiagents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger Async Run

> Start an asynchronous workflow run

# Trigger Async Run

Starts a new workflow run asynchronously. The run is queued and executed in the background. Use the [status](/api-reference/responses/status) and [response](/api-reference/responses/output) endpoints to monitor progress and retrieve results.

## Path Parameters

<ParamField path="workflowId" type="string" required>
  The unique identifier of the workflow to run
</ParamField>

## Request Body

<ParamField body="rows" type="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.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="workflowId" type="string">
      The workflow ID
    </ResponseField>

    <ResponseField name="runId" type="string">
      The unique identifier for this run. Use this to check status and retrieve results.
    </ResponseField>

    <ResponseField name="status" type="string">
      Initial status of the run. Always `queued` for async runs.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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" }
      ]
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.origamiagents.com/api/v1/workflows/wf_abc123/runs/async',
    {
      method: 'POST',
      headers: {
        'x-origami-key': 'your-api-key',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        rows: [
          { name: 'Alice', email: 'alice@example.com' },
          { name: 'Bob', email: 'bob@example.com' }
        ]
      }),
    }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.origamiagents.com/api/v1/workflows/wf_abc123/runs/async",
      headers={
          "x-origami-key": "your-api-key",
          "Content-Type": "application/json",
      },
      json={
          "rows": [
              {"name": "Alice", "email": "alice@example.com"},
              {"name": "Bob", "email": "bob@example.com"}
          ]
      },
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Success theme={null}
  {
    "success": true,
    "data": {
      "workflowId": "wf_abc123",
      "runId": "run_xyz789",
      "status": "queued"
    }
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "success": false,
    "error": "Invalid request body. Expected: { rows: [...] }"
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "success": false,
    "error": "Invalid API key"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "success": false,
    "error": "Workflow not found"
  }
  ```
</ResponseExample>