Manage Dashboard Widgets

Manage widgets in dashboard $ARGUMENTS.

Instructions

Step 1: Verify CLI Authentication

coval whoami

If no dashboard ID provided, list available dashboards:

coval dashboards list

List Widgets

coval dashboards widgets list <dashboard_id>

For JSON output with full config and grid positions:

coval dashboards widgets list <dashboard_id> --format json

Get Widget Details

coval dashboards widgets get <dashboard_id> <widget_id>

Update Widget

Update name, type, size, or config:

# Rename
coval dashboards widgets update <dashboard_id> <widget_id> --name "New Name"

# Resize
coval dashboards widgets update <dashboard_id> <widget_id> --width 24 --height 12

# Update config
coval dashboards widgets update <dashboard_id> <widget_id> \
  --config '{"metricId": "...", "visualizationType": "bar", "monitoring": "Simulations", "aggregation": "avg", "metricOutputType": "float"}'

CRITICAL: After updating, check the returned values — the server may adjust dimensions to enforce widget-type minimums per references/grid-layout.md.

Delete Widget

coval dashboards widgets delete <dashboard_id> <widget_id>

Confirm with the user before deleting.

Verify Layout

After any changes, verify no gaps in the grid:

coval dashboards widgets list <dashboard_id> --format json

Check that:

• Each row's widgets sum to 48 columns
• No vertical gaps between rows
• Sizes respect type minimums per references/grid-layout.md

Options

Flag	Description	Default
--name	Widget display name	—
--type	Widget type (chart, table, text)	—
--config	JSON config string	—
--width	Grid width in columns	—
--height	Grid height in rows	—
--page-size	Results per page (list only)	50
--format	Output format	table

Troubleshooting

Widget not found

Cause: Invalid widget ID or wrong dashboard ID. Solution: Run coval dashboards widgets list <dashboard_id> to find the correct widget ID.

Update didn't change dimensions

Cause: Requested dimensions were below the type's minimum. Solution: Consult references/grid-layout.md for valid minimums.