Batch trigger

Scope the concurrency limit to a specific key.

The delay before the task is executed. This can be a Date object, a string like 1h or a date-time string.

• "1h" - 1 hour
• "30d" - 30 days
• "15m" - 15 minutes
• "2w" - 2 weeks
• "60s" - 60 seconds
• new Date("2025-01-01T00:00:00Z")

An optional property that specifies the idempotency key used to prevent creating duplicate runs. If you provide an existing idempotency key, we will return the existing run ID.

The machine preset to use for this run. This will override the task's machine preset and any defaults.

Tags to attach to the run. Tags can be used to filter runs in the dashboard and using the SDK.

You can set up to 5 tags per run, they must be less than 64 characters each.

We recommend prefixing tags with a namespace using an underscore or colon, like user_1234567 or org:9876543. Stripe uses underscores.

The time-to-live for this run. If the run is not executed within this time, it will be removed from the queue and never execute. You can use a string in this format: 1h, 1m, 1h42m or a number of seconds (min. 1).