Dashboards

Dashboards provide customizable views for monitoring evaluation results. Each dashboard contains widgets that display charts, tables, or text.

List Dashboards

coval dashboards list [OPTIONS]

Option	Type	Default	Description
`--filter`	string	—	Filter expression
`--page-size`	number	50	Results per page
`--order-by`	string	—	Sort order

Output columns: ID, NAME, CREATED, UPDATED

coval dashboards list

Get Dashboard

coval dashboards get <dashboard_id>

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The dashboard ID

coval dashboards get db_abc123

Create Dashboard

coval dashboards create [OPTIONS]

Option	Type	Required	Description
`--name`	string	Yes	Display name
`--description`	string	No	Free-text description
`--favorite`	boolean	No	Pass `--favorite true` to mark the dashboard as a favorite, `--favorite false` to unmark it
`--default`	boolean	No	Pass `--default true` to make this the organization’s default dashboard (unsets any other default). If omitted, the first dashboard created in an organization automatically becomes the default
`--position`	number	No	Ordering position (`>= 0`). Omit to append to the end
`--config`	string	No	Free-form JSON config: a JSON string or `@filepath`

coval dashboards create \
  --name "Production Metrics" \
  --description "Latency and quality overview" \
  --default true

Update Dashboard

coval dashboards update <dashboard_id> [OPTIONS]

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The dashboard ID to update

Option	Type	Description
`--name`	string	New display name
`--description`	string	New description (empty string clears it)
`--favorite`	boolean	Pass `--favorite true` to mark the dashboard as a favorite, `--favorite false` to unmark it
`--default`	boolean	Pass `--default true` to make this the organization’s default dashboard (unsets any other default)
`--position`	number	New ordering position (`>= 0`)
`--config`	string	Replacement JSON config or `@filepath`. Fully replaces the stored config

# Rename and make this the default dashboard
coval dashboards update db_abc123 --name "Staging Metrics" --default true

PATCH semantics: omitted options are left unchanged. To clear a value, send an empty string for --description or an empty object (--config '{}'). Replacing --config overwrites any UI-managed keys such as saved date preferences.

Delete Dashboard

coval dashboards delete <dashboard_id>

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The dashboard ID to delete

coval dashboards delete db_abc123

Widgets

Widgets are visual components that live inside a dashboard. All widget commands are nested under coval dashboards widgets.

List Widgets

coval dashboards widgets list <dashboard_id> [OPTIONS]

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The parent dashboard ID

Option	Type	Default	Description
`--page-size`	number	50	Results per page

Output columns: ID, NAME, TYPE, GRID, CREATED

coval dashboards widgets list db_abc123

coval dashboards widgets get <dashboard_id> <widget_id>

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The parent dashboard ID
`widget_id`	string	Yes	The widget ID

coval dashboards widgets get db_abc123 wgt_xyz789

coval dashboards widgets create <dashboard_id> [OPTIONS]

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The parent dashboard ID

Option	Type	Required	Description
`--name`	string	Yes	Widget display name
`--type`	string	Yes	Widget type (see below)
`--config`	string	No	JSON config string or `@filepath` to read from file
`--grid-w`	number	No	Grid width
`--grid-h`	number	No	Grid height
`--grid-x`	number	No	Grid X position
`--grid-y`	number	No	Grid Y position

Type	Description
`chart`	Line, bar, or area chart visualization
`table`	Tabular data display
`text`	Static text or markdown content

# Create a chart widget
coval dashboards widgets create db_abc123 \
  --name "Score Trends" \
  --type chart \
  --config '{"metric_id": "met_001"}' \
  --grid-w 6 \
  --grid-h 4

# Create a widget with config from a file
coval dashboards widgets create db_abc123 \
  --name "Detailed Report" \
  --type table \
  --config @widget-config.json

coval dashboards widgets update <dashboard_id> <widget_id> [OPTIONS]

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The parent dashboard ID
`widget_id`	string	Yes	The widget ID to update

Option	Type	Description
`--name`	string	New display name
`--type`	string	New widget type
`--config`	string	New JSON config or `@filepath`
`--grid-w`	number	New grid width
`--grid-h`	number	New grid height
`--grid-x`	number	New grid X position
`--grid-y`	number	New grid Y position

coval dashboards widgets update db_abc123 wgt_xyz789 \
  --grid-w 12 --grid-h 6

coval dashboards widgets delete <dashboard_id> <widget_id>

Argument	Type	Required	Description
`dashboard_id`	string	Yes	The parent dashboard ID
`widget_id`	string	Yes	The widget ID to delete

coval dashboards widgets delete db_abc123 wgt_xyz789

Getting Started

Resources

List Dashboards

Get Dashboard

Create Dashboard

Update Dashboard

Delete Dashboard

Widgets

List Widgets

Get Widget

Create Widget

Widget Types

Update Widget

Delete Widget

​List Dashboards

​Get Dashboard

​Create Dashboard

​Update Dashboard

​Delete Dashboard

​Widgets

​List Widgets

​Get Widget

​Create Widget

​Widget Types

​Update Widget

​Delete Widget

List Dashboards

Get Dashboard

Create Dashboard

Update Dashboard

Delete Dashboard

Widgets

List Widgets

Get Widget

Create Widget

Widget Types

Update Widget

Delete Widget