Skip to main content
POST
/
api
/
v1
/
bulk-actions
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);
{
  "id": "bulk_1234"
}
{
  "error": "Something went wrong"
}
{
  "error": "Something went wrong"
}
{
  "error": "Something went wrong"
}

Authorizations

​
Authorization
string
header
required

Use your project-specific Secret API key. Will start with tr_dev_, tr_prod, tr_stg, etc.

You can find your Secret API key in the API Keys section of your Trigger.dev project dashboard.

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_1234" });

Body

application/json
​
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.

​
name
string
Maximum string length: 255

Response

Bulk action accepted

​
id
string
required
Example:

"bulk_1234"