Compare commits

...
Author SHA1 Message Date
rusackasandClaude Opus 4.8 091b267cae docs(mcp): note reports-exist check precedes editorship for delete tools
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-07 02:26:23 -07:00
rusackasandClaude Opus 4.8 46ba83961a docs(mcp): describe delete_chart/delete_dashboard permission as editorship
The table entries said permission_denied is returned when the caller
isn't owner/Admin, but DeleteChartCommand/DeleteDashboardCommand actually
gate on security_manager.raise_for_editorship, which also allows
explicitly granted editors (not just owners and Admins) to delete.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-04 23:20:55 -07:00
rusackasandClaude Sonnet 5 24cd80084b docs(mcp): document delete_chart and delete_dashboard tools
The MCP AI-tools reference table covered create/read/update tools for
charts and dashboards but was missing the delete_chart and
delete_dashboard tools added in #41472, including their
soft_deleted/permission_denied response semantics.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-04 13:14:27 -07:00
@@ -269,26 +269,28 @@ Ask your admin for the MCP server URL and any authentication tokens you need.
### Charts
| Tool | Description |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `list_charts` | List charts with filtering and search |
| `get_chart_info` | Get chart metadata and configuration |
| `get_chart_data` | Retrieve chart data (JSON, CSV, or Excel) |
| `get_chart_preview` | Generate a chart preview (URL, ASCII, table, or Vega-Lite) |
| `get_chart_type_schema` | Get the configuration schema for a chart type |
| `generate_chart` | Create a new chart from a specification (defaults to preview mode — review before saving) |
| `update_chart` | Modify an existing chart's configuration (pass `generate_preview=False` to persist immediately instead of returning a preview URL) |
| `update_chart_preview` | Update a cached chart preview without saving |
| `generate_explore_link` | Generate an Explore URL for interactive visualization |
| Tool | Description |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_charts` | List charts with filtering and search |
| `get_chart_info` | Get chart metadata and configuration |
| `get_chart_data` | Retrieve chart data (JSON, CSV, or Excel) |
| `get_chart_preview` | Generate a chart preview (URL, ASCII, table, or Vega-Lite) |
| `get_chart_type_schema` | Get the configuration schema for a chart type |
| `generate_chart` | Create a new chart from a specification (defaults to preview mode — review before saving) |
| `update_chart` | Modify an existing chart's configuration (pass `generate_preview=False` to persist immediately instead of returning a preview URL) |
| `update_chart_preview` | Update a cached chart preview without saving |
| `generate_explore_link` | Generate an Explore URL for interactive visualization |
| `delete_chart` | Delete a chart by ID or UUID (soft-deletes to trash when `SOFT_DELETE` is enabled; fails if alerts/reports are still attached, checked before editorship; otherwise returns `permission_denied` if the caller isn't an editor of the chart — owners, Admins, and explicitly granted editors qualify) |
### Dashboards
| Tool | Description |
| --------------------------------- | -------------------------------------------- |
| `list_dashboards` | List dashboards with filtering and search |
| `get_dashboard_info` | Get dashboard metadata and layout |
| `generate_dashboard` | Create a new dashboard with specified charts |
| `add_chart_to_existing_dashboard` | Add a chart to an existing dashboard |
| Tool | Description |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `list_dashboards` | List dashboards with filtering and search |
| `get_dashboard_info` | Get dashboard metadata and layout |
| `generate_dashboard` | Create a new dashboard with specified charts |
| `add_chart_to_existing_dashboard` | Add a chart to an existing dashboard |
| `delete_dashboard` | Delete a dashboard by ID, UUID, or slug; leaves its charts intact (soft-deletes to trash when `SOFT_DELETE` is enabled; fails if alerts/reports are still attached, checked before editorship; otherwise returns `permission_denied` if the caller isn't an editor of the dashboard — owners, Admins, and explicitly granted editors qualify) |
### SQL