Agent Schedules

Use schedules when an agent should run without an external cron job. Schedule commands use the public control-plane API and accept the same agent locator as other control-plane commands: pass an agent_... id or the agent slug.

Create a weekly cron schedule

spinup agents schedules create newsletter \
  --cron "0 9 * * 5" \
  --timezone Europe/Amsterdam \
  --name "Friday newsletter" \
  --input "Draft the weekly newsletter"

Cron schedules use five-field cron syntax. The timezone must be an IANA timezone and must match the cron cadence timezone saved by Spinup.

Create a disabled schedule:

spinup agents schedules create newsletter \
  --cron "0 9 * * 5" \
  --timezone Europe/Amsterdam \
  --name "Friday newsletter" \
  --input "Draft the weekly newsletter" \
  --disabled

Preview upcoming runs

spinup agents schedules preview newsletter \
  --cron "0 9 * * 5" \
  --timezone Europe/Amsterdam

List and update schedules

spinup agents schedules list newsletter

spinup agents schedules update newsletter agentsched_01hxyz... \
  --name "Updated Friday newsletter" \
  --enabled true

Disable or delete

Disable keeps the schedule record and history:

spinup agents schedules disable newsletter agentsched_01hxyz...

Delete removes the schedule from future dispatch:

spinup agents schedules delete newsletter agentsched_01hxyz...

Use --json on any schedule command for scripting.

Scheduled dispatch starts normal Spinup runs. The agent needs an active deploy/release before a schedule can execute successfully; if there is no deployable active release, Spinup records the blocked scheduled occurrence and pauses the schedule for action.