Skip to main content
Base URL: http://localhost:3100

​
List schedules for a task

GET /tasks/:id/schedules
Example
curl http://localhost:3100/tasks/42/schedules

​
Create a schedule

POST /tasks/:id/schedules
​
type
string
required
Schedule type: one_time, interval, weekly, monthly
​
fire_at
string
ISO 8601 datetime for one-time schedules
​
interval_days
number
Repeat interval in days (for interval type)
​
day_of_week
number
Day of week 0-6 (for weekly type)
​
day_of_month
number
Day of month 1-31 (for monthly type)
​
time
string
Time of day in HH:MM format (for weekly and monthly)
Example — one-time
curl -X POST http://localhost:3100/tasks/42/schedules \
  -H "Content-Type: application/json" \
  -d '{"type": "one_time", "fire_at": "2025-03-15T09:00:00Z"}'
Example — interval
curl -X POST http://localhost:3100/tasks/42/schedules \
  -H "Content-Type: application/json" \
  -d '{"type": "interval", "interval_days": 3}'

​
Update a schedule

PATCH /tasks/:id/schedules/:scheduleId

​
Delete a schedule

DELETE /tasks/:id/schedules/:scheduleId
Example
curl -X DELETE http://localhost:3100/tasks/42/schedules/7