> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coval.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Runs

> Schedule recurring evaluation runs with the Coval CLI

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

## List Scheduled Runs

```bash theme={null}
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

```bash theme={null}
# 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

```bash theme={null}
coval scheduled-runs get <scheduled_run_id>
```

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

```bash theme={null}
coval scheduled-runs get sr_abc123
```

## Create Scheduled Run

```bash theme={null}
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      |

```bash theme={null}
# 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

```bash theme={null}
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 |

```bash theme={null}
# 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

```bash theme={null}
coval scheduled-runs delete <scheduled_run_id>
```

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

```bash theme={null}
coval scheduled-runs delete sr_abc123
```