Skip to main content
POST
/
v2
/
batch
/
trigger
Batch Trigger Workflow Runs
curl --request POST \
  --url https://qstash.upstash.io/v2/batch/trigger \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "destination": "<string>",
    "body": "<string>",
    "headers": {}
  }
]
'
[
  {
    "workflowRunId": "<string>",
    "workflowCreatedAt": 123,
    "deduplicated": true
  }
]

Documentation Index

Fetch the complete documentation index at: https://upstash.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

QStash authentication token

Body

application/json
​
destination
string
required

The URL of the workflow to trigger.

​
body
string

The raw request payload passed to the workflow endpoint as is. You can access it via request payload parameter on the context object.

​
headers
object

HTTP headers to forward to the workflow. You can pass any headers supported in the single trigger API.

Response

Workflow runs triggered successfully

​
workflowRunId
string

The ID of the triggered workflow run.

​
workflowCreatedAt
integer<int64>

The unix timestamp in milliseconds when the workflow run was created.

​
deduplicated
boolean

Whether the workflow run was deduplicated (i.e. a run with the same ID already existed and a new one was not created).