Skip to main content
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]
OptionTypeDefaultDescription
--filterstring—Filter expression
--page-sizenumber50Results per page
--order-bystring—Sort order
--enabledboolean—Filter by enabled status (true or false)
--template-idstring—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>
ArgumentTypeRequiredDescription
scheduled_run_idstringYesThe scheduled run ID
coval scheduled-runs get sr_abc123

​
Create Scheduled Run

coval scheduled-runs create [OPTIONS]
OptionTypeRequiredDescription
--namestringYesDisplay name
--template-idstringYesRun template to execute
--schedulestringYesCron expression (e.g., 0 9 * * *)
--timezonestringNoIANA timezone (default: UTC)
--enabledbooleanNoWhether 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]
ArgumentTypeRequiredDescription
scheduled_run_idstringYesThe scheduled run ID to update
OptionTypeDescription
--namestringNew display name
--schedulestringNew cron expression
--timezonestringNew IANA timezone
--enabledbooleanEnable 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>
ArgumentTypeRequiredDescription
scheduled_run_idstringYesThe scheduled run ID to delete
coval scheduled-runs delete sr_abc123