Fundamentals
Development
Deployment
- Environment Variables
- CLI deploy command
- GitHub Actions
- Deployment integrations
Writing tasks
API reference
- Functions
- Objects
- CLI
- Runs API
- Schedules API
Architecture
Open source
Schedules API
Create Schedule
Create a new schedule based on the specified options.
POST
/
api
/
v1
/
schedules
Copy
import { schedules } from "@trigger.dev/sdk/v3";
const schedule = await schedules.create({
task: 'my-task',
cron: '0 0 * * *'
});
Copy
{
"id": "sched_1234",
"task": "my-scheduled-task",
"active": true,
"deduplicationKey": "dedup_key_1234",
"externalId": "user_1234",
"generator": {
"type": "CRON",
"expression": "0 0 * * *",
"description": "Every day at midnight"
},
"nextRun": "2024-04-01T00:00:00Z",
"environments": [
{
"id": "<string>",
"type": "<string>",
"userName": "<string>"
}
]
}
Authorizations
Use your Secret API key in the form 'Bearer <SECRET KEY>' (without the quotation marks)
Body
application/json
Response
200
application/json
Schedule created successfully
The response is of type object
.
Was this page helpful?
Copy
import { schedules } from "@trigger.dev/sdk/v3";
const schedule = await schedules.create({
task: 'my-task',
cron: '0 0 * * *'
});
Copy
{
"id": "sched_1234",
"task": "my-scheduled-task",
"active": true,
"deduplicationKey": "dedup_key_1234",
"externalId": "user_1234",
"generator": {
"type": "CRON",
"expression": "0 0 * * *",
"description": "Every day at midnight"
},
"nextRun": "2024-04-01T00:00:00Z",
"environments": [
{
"id": "<string>",
"type": "<string>",
"userName": "<string>"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.