skills/sentry-cli/references/dashboard.md

name, version, description, requires

name	version	description	requires
sentry-cli-dashboard	0.33.0	Manage Sentry dashboards	bins auth sentry true

Dashboard Commands

Manage Sentry dashboards

sentry dashboard list <org/title-filter...>

List dashboards

Flags:

• -w, --web - Open in browser
• -n, --limit <value> - Maximum number of dashboards to list - (default: "25")
• -f, --fresh - Bypass cache, re-detect projects, and fetch fresh data
• -c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)

Examples:

# List all dashboards
sentry dashboard list

# Filter by name pattern
sentry dashboard list "Backend*"

# Open dashboard list in browser
sentry dashboard list -w

sentry dashboard view <org/project/dashboard...>

View a dashboard

Flags:

• -w, --web - Open in browser
• -f, --fresh - Bypass cache, re-detect projects, and fetch fresh data
• -r, --refresh <value> - Auto-refresh interval in seconds (default: 60, min: 10)
• -t, --period <value> - Time range: "7d", "2026-04-01..2026-05-01", ">=2026-04-01"

Examples:

# View by title
sentry dashboard view 'Frontend Performance'

# View by ID
sentry dashboard view 12345

# Auto-refresh every 30 seconds
sentry dashboard view "Backend Performance" --refresh 30

# Open in browser
sentry dashboard view 12345 -w

sentry dashboard create <org/project/title...>

Create a dashboard

Examples:

sentry dashboard create 'Frontend Performance'

sentry dashboard widget add <org/project/dashboard/title...>

Add a widget to a dashboard

Flags:

• -d, --display <value> - Display type (big_number, line, area, bar, table, stacked_area, top_n, text, categorical_bar, details, wheel, rage_and_dead_clicks, server_tree, agents_traces_table)
• --dataset <value> - Widget dataset (default: spans). Accepts canonical names and API synonyms: spans, error-events/errors, transaction-like/transactions, tracemetrics/metrics, logs, issue, discover
• -q, --query <value>... - Aggregate expression (e.g. count, p95:span.duration)
• -w, --where <value> - Search conditions filter (e.g. is:unresolved)
• -g, --group-by <value>... - Group-by column (repeatable)
• -s, --sort <value> - Order by (prefix - for desc, e.g. -count)
• -n, --limit <value> - Result limit
• -x, --col <value> - Grid column position (0-based, 0–5)
• -y, --row <value> - Grid row position (0-based)
• --width <value> - Widget width in grid columns (1–6)
• --height <value> - Widget height in grid rows (min 1)
• -l, --layout <value> - Layout mode: sequential (append in order) or dense (fill gaps) - (default: "sequential")

Examples:

# Simple counter widget
sentry dashboard widget add 'My Dashboard' "Error Count" \
  --display big_number --query count

# Line chart with group-by
sentry dashboard widget add 'My Dashboard' "Errors by Browser" \
  --display line --query count --group-by browser.name

# Table with multiple aggregates, sorted descending
sentry dashboard widget add 'My Dashboard' "Top Endpoints" \
  --display table \
  --query count --query p95:span.duration \
  --group-by transaction \
  --sort -count --limit 10

# With search filter
sentry dashboard widget add 'My Dashboard' "Slow Requests" \
  --display bar --query p95:span.duration \
  --where "span.op:http.client" \
  --group-by span.description

sentry dashboard widget edit <org/project/dashboard...>

Edit a widget in a dashboard

Flags:

• -i, --index <value> - Widget index (0-based)
• -t, --title <value> - Widget title to match
• --new-title <value> - New widget title
• -d, --display <value> - Display type (big_number, line, area, bar, table, stacked_area, top_n, text, categorical_bar, details, wheel, rage_and_dead_clicks, server_tree, agents_traces_table)
• --dataset <value> - Widget dataset (default: spans). Accepts canonical names and API synonyms: spans, error-events/errors, transaction-like/transactions, tracemetrics/metrics, logs, issue, discover
• -q, --query <value>... - Aggregate expression (e.g. count, p95:span.duration)
• -w, --where <value> - Search conditions filter (e.g. is:unresolved)
• -g, --group-by <value>... - Group-by column (repeatable)
• -s, --sort <value> - Order by (prefix - for desc, e.g. -count)
• -n, --limit <value> - Result limit
• -x, --col <value> - Grid column position (0-based, 0–5)
• -y, --row <value> - Grid row position (0-based)
• --width <value> - Widget width in grid columns (1–6)
• --height <value> - Widget height in grid rows (min 1)

Examples:

# Change display type
sentry dashboard widget edit 12345 --title 'Error Count' --display bar

# Rename a widget
sentry dashboard widget edit 'My Dashboard' --index 0 --new-title 'Total Errors'

# Change the query
sentry dashboard widget edit 12345 --title 'Error Rate' --query p95:span.duration

sentry dashboard widget delete <org/project/dashboard...>

Delete a widget from a dashboard

Flags:

• -i, --index <value> - Widget index (0-based)
• -t, --title <value> - Widget title to match
• -y, --yes - Skip confirmation prompt
• -f, --force - Force the operation without confirmation
• -n, --dry-run - Show what would happen without making changes

Examples:

# Delete by title
sentry dashboard widget delete 'My Dashboard' --title 'Error Count'

# Delete by index
sentry dashboard widget delete 12345 --index 2

sentry dashboard revisions <org/dashboard...>

List dashboard revisions

Flags:

• -n, --limit <value> - Maximum number of revisions to list - (default: "25")
• -c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)

sentry dashboard restore <org/dashboard...>

Restore a dashboard revision

Flags:

• -r, --revision <value> - Revision ID to restore

All commands also support --json, --fields, --help, --log-level, and --verbose flags.