Scheduled Runs - Coval Documentation

Scheduled runs automatically launch evaluations on a recurring basis using a run template and a cron-style schedule expression.

List Scheduled Runs

coval scheduled-runs list [OPTIONS]

Option	Type	Default	Description
`--filter`	string	—	Filter expression
`--page-size`	number	50	Results per page
`--order-by`	string	—	Sort order
`--enabled`	boolean	—	Filter by enabled status (`true` or `false`)
`--template-id`	string	—	Filter by run template ID

Output columns: ID, NAME, TEMPLATE, SCHEDULE, TIMEZONE, ENABLED, LAST RUN

# List all scheduled runs
coval scheduled-runs list

# List only enabled schedules
coval scheduled-runs list --enabled true

# Filter by template
coval scheduled-runs list --template-id rt_abc123

Get Scheduled Run

coval scheduled-runs get <scheduled_run_id>

Argument	Type	Required	Description
`scheduled_run_id`	string	Yes	The scheduled run ID

coval scheduled-runs get sr_abc123

Create Scheduled Run

coval scheduled-runs create [OPTIONS]

Option	Type	Required	Description
`--name`	string	Yes	Display name
`--template-id`	string	Yes	Run template to execute
`--schedule`	string	Yes	Cron expression (e.g., `0 9 * * *`)
`--timezone`	string	No	IANA timezone (default: UTC)
`--enabled`	boolean	No	Whether the schedule is active

# Run every day at 9am UTC
coval scheduled-runs create \
  --name "Daily Regression" \
  --template-id rt_abc123 \
  --schedule "0 9 * * *"

# Run weekdays at 6am Pacific, starting disabled
coval scheduled-runs create \
  --name "Weekday Check" \
  --template-id rt_abc123 \
  --schedule "0 6 * * 1-5" \
  --timezone "America/Los_Angeles" \
  --enabled false

Update Scheduled Run

coval scheduled-runs update <scheduled_run_id> [OPTIONS]

Argument	Type	Required	Description
`scheduled_run_id`	string	Yes	The scheduled run ID to update

Option	Type	Description
`--name`	string	New display name
`--schedule`	string	New cron expression
`--timezone`	string	New IANA timezone
`--enabled`	boolean	Enable or disable the schedule

# Disable a schedule
coval scheduled-runs update sr_abc123 --enabled false

# Change schedule to hourly
coval scheduled-runs update sr_abc123 --schedule "0 * * * *"

Delete Scheduled Run

coval scheduled-runs delete <scheduled_run_id>

Argument	Type	Required	Description
`scheduled_run_id`	string	Yes	The scheduled run ID to delete

coval scheduled-runs delete sr_abc123

⌘I