schedule

Schedules are named, reusable cadences (cron expression + timezone) that drive recurring operations — sync applies, run commands, backup runs, and the update windows of firmware tracks. The schedule command surface has two sub-groups: schedule (cadence CRUD) and schedule tasks (management of the recurring operations attached to a schedule).

Commands

Command	Description
schedule create	Create a new schedule
schedule list	List all schedules in the organization
schedule describe	Show details for a single schedule
schedule enable	Enable a schedule
schedule disable	Disable a schedule
schedule delete	Delete a schedule
schedule tasks list	List all scheduled tasks
schedule tasks enable	Enable a scheduled task
schedule tasks disable	Disable a scheduled task
schedule tasks remove	Remove a scheduled task

---

schedule create

Create a new named schedule.

ndcli schedule create [flags]

Flags

Flag	Type	Required	Description
--name	string	Yes	Unique name within the organization
--cron	string	Yes	Standard 5-field cron expression (e.g., "0 3 * * *")
--timezone	string	No	IANA timezone name (e.g., America/New_York, UTC). Default UTC
--disabled	bool	No	Create the schedule in a disabled state. Default: enabled

Examples

ndcli schedule create --name nightly-maintenance --cron "0 3 * * *" --timezone America/New_York

ndcli schedule create --name monday-reboot --cron "0 4 * * 1" --timezone America/Chicago

ndcli schedule create --name monthly-audit --cron "0 0 1 * *" --timezone UTC

---

schedule list

List all schedules in the organization.

ndcli schedule list

Examples

ndcli schedule list

ndcli schedule list -f json

---

schedule describe

Show a schedule and the task specs registered on it. A spec of kind FIRMWARE is the update window of a firmware track, and is listed with the track’s name, for example fast track window. With -f json it carries firmware_track, which is null for every other kind.

ndcli schedule describe <name>

Arguments

Argument	Required	Description
name	Yes	Schedule name

Examples

ndcli schedule describe nightly-maintenance

ndcli schedule describe nightly-maintenance -f json

---

schedule enable

Enable a schedule. All scheduled tasks attached to it will resume firing.

ndcli schedule enable <name>

Arguments

Argument	Required	Description
name	Yes	Schedule name

Examples

ndcli schedule enable nightly-maintenance

---

schedule disable

Disable a schedule. All scheduled tasks attached to it are paused until re-enabled.

ndcli schedule disable <name>

Arguments

Argument	Required	Description
name	Yes	Schedule name

Examples

ndcli schedule disable nightly-maintenance

Caution

Disabling a schedule pauses every recurring task that references it, the windows of a firmware track included: a track on a disabled schedule doesn’t run. Use schedule tasks disable if you want to pause only a specific operation.

---

schedule delete

Delete a schedule and every task spec registered on it. It asks for confirmation first.

ndcli schedule delete <name> [--force]

Arguments

Argument	Required	Description
name	Yes	Schedule name

Flags

Flag	Type	Default	Description
--force	bool	false	Skip the confirmation prompt. Required when stdin is not a terminal

Examples

ndcli schedule delete monthly-audit

A schedule that a firmware track runs on can’t be deleted

Deleting it would leave the track’s devices pinned with nothing to move them. The command refuses, names the tracks, and tells you how to detach them first:

Error: [FIRMWARE_SPEC_MANAGED] This schedule carries the update windows of firmware tracks fast, regular. Deleting it would leave their devices pinned with nothing to move them. Detach the tracks from this schedule in the firmware configuration first, then delete it.
  Hint: To detach the tracks from their schedule: 'ndcli firmware track schedule fast --no-schedule'; 'ndcli firmware track schedule regular --no-schedule'. To move them to another schedule: 'ndcli firmware track schedule fast <schedule>'; 'ndcli firmware track schedule regular <schedule>'.

Nothing is deleted. Detach each track with firmware track schedule, then delete the schedule.

---

schedule tasks list

List all scheduled tasks (recurring operations) in the organization.

ndcli schedule tasks list [flags]

Flags

Flag	Type	Default	Description
--schedule	string		Filter by schedule name

╭──────────┬────────────────┬──────────┬───────────┬──────────────────────────────────╮
│ Code     │ Schedule       │ Kind     │ Status    │ Request                          │
├──────────┼────────────────┼──────────┼───────────┼──────────────────────────────────┤
│ Fw123456 │ saturday-night │ FIRMWARE │ ● ENABLED │ fast track window                │
│ Rn654321 │ nightly        │ RUN      │ ● ENABLED │ type=PING devices=[fw-branch-01] │
╰──────────┴────────────────┴──────────┴───────────┴──────────────────────────────────╯

A spec of kind FIRMWARE is the update window of a firmware track, listed with the track’s name. -f json carries it as firmware_track, which is null for every other kind.

Examples

ndcli schedule tasks list

ndcli schedule tasks list --schedule nightly-maintenance

ndcli schedule tasks list -f json

---

schedule tasks enable

Enable a specific scheduled task. Overrides a task-level disable without affecting the schedule or other tasks.

ndcli schedule tasks enable <code>

Arguments

Argument	Required	Description
code	Yes	Scheduled task code

Examples

ndcli schedule tasks enable a1b2c3d4

A firmware track’s window can’t be enabled or disabled here: it belongs to the track, and the control plane refuses. Attach or detach the track’s schedule with firmware track schedule.

---

schedule tasks disable

Disable a specific scheduled task. The schedule continues to fire; only this task is paused.

ndcli schedule tasks disable <code>

Arguments

Argument	Required	Description
code	Yes	Scheduled task code

Examples

ndcli schedule tasks disable a1b2c3d4

---

schedule tasks remove

Permanently remove a scheduled task. Future executions are stopped. The schedule itself is unaffected. It asks for confirmation first.

ndcli schedule tasks remove <code> [--force]

Arguments

Argument	Required	Description
code	Yes	Scheduled task code

Flags

Flag	Type	Default	Description
--force	bool	false	Skip the confirmation prompt. Required when stdin is not a terminal

Examples

ndcli schedule tasks remove a1b2c3d4

A firmware track’s window can’t be removed this way. The command refuses before it asks anything:

Error: Spec Fw123456 is a firmware track's update window and belongs to the track: detach the track from its schedule with 'ndcli firmware track schedule fast --no-schedule', or move it to another schedule with 'ndcli firmware track schedule fast <schedule>'