Deactivate Schedule
Deactivate a schedule by its ID. This will only work on IMPERATIVE
schedules that were created in the dashboard or using the imperative SDK functions like schedules.create()
.
Authorizations
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/v3";
configure({ accessToken: "tr_dev_1234" });
Path Parameters
The ID of the schedule.
Response
The unique ID of the schedule, prefixed with 'sched_'
"sched_1234"
The id of the scheduled task that will be triggered by this schedule
"my-scheduled-task"
The type of schedule, DECLARATIVE
or IMPERATIVE
. Declarative schedules are declared in your code by setting the cron
property on a schedules.task
. Imperative schedules are created in the dashboard or by using the imperative SDK functions like schedules.create()
.
"IMPERATIVE"
Whether the schedule is active or not
true
The deduplication key used to prevent creating duplicate schedules
"dedup_key_1234"
The external ID of the schedule. Can be anything that is useful to you (e.g., user ID, org ID, etc.)
"user_1234"
Defaults to UTC. In IANA format, if set then it will trigger at the CRON frequency in that timezone and respect daylight savings time.
"America/New_York"
The next time the schedule will run
"2024-04-01T00:00:00Z"