TriggerClient: cancelRunsForJob() Instance Method

The cancelRunsForJob() instance method will cancel all job runs (yet to be executed) with the given jobId.

These are the docs for Trigger.dev v2 which will be deprecated on January 31st, 2025. You probably want the v3 docs.

Parameters

jobId · string · required

The job ID to cancel the job runs for. This is the id you set when using client.defineJob() or new Job().

Returns

Hide properties

cancelledRunIds · array · required

List of Job Run IDs that are cancelled.

failedToCancelRunIds · array · required

List of Job Run IDs that have failed to be cancelled.

Cancelling Runs for an Event

//this is the job we want to cancel runs for
client.defineJob({
  //this is the job id
  id: "my-job",
  name: "My first job",
  version: "1.0.0",
  trigger: invokeTrigger({ schema: z.number() }),
  run: async (payload, io, ctx) => {
    await io.logger.info(`Hello World ${payload}`);
  },
});

// Some time later...
const res = await client.cancelRunsForJob("my-job");
console.log(res.cancelledRunIds);
console.log(res.failedToCancelRunIds);