Monito CLI

automation

Manage automations — schedules, deploy webhook, and GitHub CI — for a project.

Automations fire a project's tests without manual intervention. There are three kinds:

  • schedule — runs on a recurring UTC schedule. Managed with the commands below.
  • webhook — fires when your deploy pipeline POSTs to the project's webhook URL. See the deploy webhook guide.
  • github_ci — created by monito ci apply. See the CI guide.

All commands require --project <id> and support --json.

automation list

List a project's automations, including the deploy webhook and GitHub CI rows.

monito automation list --project <id>
monito automation ls --project <id> --json

Displays: ID, Kind, Name, Environment, Suite, Enabled, Next Fire (UTC).

automation create

Create a schedule automation.

monito automation create --project <id> \
  --name "Nightly regression" \
  --preset daily \
  --hour-utc 6
FlagRequiredDescription
--project <id>YesProject ID
--name <name>YesAutomation name
--preset <preset>Yeshourly, every6h, daily, weekly
--hour-utc <n>NoHour to fire, 0-23 UTC. Applies to daily/weekly (default 0)
--weekday <n>NoWeekday to fire, 0=Sunday … 6=Saturday. Applies to weekly (default 1)
--environment <id>NoEnvironment ID. Default: the project's default environment at fire time
--suite <id>NoSuite ID. Default: all tests
--jsonNoOutput as JSON

Schedules are presets, not cron expressions — the smallest interval is hourly. All times are UTC.

Omit --environment/--suite to target the project's default environment and every scenario. Run automation list first to avoid creating duplicates.

automation update

Update an automation. All flags are optional — only provided values are changed. Changing the schedule or re-enabling recomputes the next fire time from now.

monito automation update <id> --project <id> --preset weekly --weekday 1 --hour-utc 8
monito automation update <id> --project <id> --disable
FlagDescription
--name <name>Rename
--preset <preset>New schedule preset (required when passing --hour-utc/--weekday)
--hour-utc <n>New hour, 0-23 UTC
--weekday <n>New weekday, 0=Sunday … 6=Saturday
--environment <id>Target a specific environment
--reset-environmentReset to the project's default environment
--suite <id>Target a specific suite
--reset-suiteReset to all tests
--enable / --disableEnable or disable
--jsonOutput as JSON

automation delete

Delete an automation. Requires --yes to confirm.

monito automation delete <id> --project <id> --yes

Deleting the webhook automation disables the deploy webhook; deleting the github_ci automation removes the CI binding.

Previous

project

Next

scenario

On this page