Create bulk action

Create an asynchronous bulk action to cancel or replay runs selected by run IDs or filters.

POST /api/v1/bulk-actions

TypeScript

Replay matching runs

import { runs } from "@trigger.dev/sdk"; const action = await runs.bulk.replay({ filter: { status: "FAILED", taskIdentifier: "sync-customer", period: "24h", }, name: "Replay failed customer syncs", }); console.log(action.id);

202

{
  "id": "bulk_1234"
}

Authorizations

Authorization · string · header · required

Use a named environment API key. It starts with tr_dev_sk_, tr_prod_sk_, tr_stg_sk_, etc.

Create a named API key in the API Keys section of your Trigger.dev project dashboard. Choose the narrowest access preset that supports your integration.

Our TypeScript SDK will default to using the value of the TRIGGER_SECRET_KEY environment variable if it is set. If you are using the SDK in a different environment, you can set the key using the configure function.

import { configure } from "@trigger.dev/sdk";

configure({ accessToken: "tr_dev_sk_1234" });

Body

application/json

Cancel by filter

Cancel by run IDs

Replay by filter

Replay by run IDs

action · enum<string> · required

Available options: cancel

filter · object · required

Selects runs using SDK-style run-list filter fields, excluding pagination fields. In HTTP requests these fields are sent as JSON body properties, so time fields are top-level (from, to, period) instead of nested under createdAt. Provide at least one property.

Show child attributes

name · string

Maximum string length: 255

Response

202

application/json

Bulk action accepted

id · string · required

Example:

"bulk_1234"