- API Reference
- Box API
- Rotation settings
List scheduled rotation jobs of one or more slots
Use this to see which automatic rotations are planned and when they run next. Lists both system jobs (created with rotation_add_job) and selling-port interval jobs. POST is used only to carry the body; nothing changes. Returns an empty list while the scheduler is not running. A missing field returns status false without data.
/v2/schedule/rotation_jobsRequest body application/json · required
Slots to list; an empty list lists every slot.
Responses
Jobs page, or status false on a bad body.
seconds, minutes, hoursTime of day (hh:mm) the job is aligned to.
Start of the daily window (hh:mm:ss); null runs all day.
system jobs come from this API; selling jobs come from a selling port interval rotation.
system, sellingEpoch seconds of the next run.
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.