Documentation Index
Fetch the complete documentation index at: https://docs.coval.dev/llms.txt
Use this file to discover all available pages before exploring further.
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 |
# 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
