Update Task Schedule by ID
PUT/api/v1/tasks/:id/schedule
Updates recurrence settings only; this operation does not change startTime or timeZoneId (use UpdateTaskStartTime). Valid targets are Hourly, Daily, Weekly, Monthly, and RealTime; Once is not an update target. Use positive runEvery values for Hourly, Daily, or Monthly schedules; scheduleDays uses 0–6 for Weekly or 1–28 and -1 for the last day for Monthly. realTimeDelayInMinutes is optional (1–59) and can be changed in place for an existing RealTime task, but transitions to or from RealTime are rejected. Invalid values or transitions return 400; unknown task IDs return 404.
Request
Responses
- 200
- 400
- 401
- 404
- 429
Updated task schedule.
The schedule values are invalid or the requested RealTime frequency transition is not supported.
Unauthorized
No task exists with the specified ID.
The request was rate limited; retry after the interval in the Retry-After header when supplied.
Response Headers
Number of seconds to wait before retrying; omitted when the server cannot provide a retry interval.