edit_dashboard_widget
Edit an existing widget in a dashboard.
Edit an existing widget in a dashboard.
Destructive · Writes data · Idempotent · Calls external systems. This tool can modify or delete data. Review the arguments before letting an agent call it.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
acknowledge | boolean | No | Set to true after user approves continuing past the edit limit. |
dashboard_uid | string | Yes | Dashboard UID |
h | number | No | New grid height (optional) |
w | number | No | New grid width (optional) |
widget_id | string | Yes | Widget ID within the dashboard (the 'i' field from get_dashboard layout) |
widget_json | string | Yes | JSON string of the new widget data section |
x | number | No | New grid x position (optional — preserves current if omitted) |
y | number | No | New grid y position (optional) |
Example arguments
Illustrative arguments an agent supplies when calling this tool:
{
"dashboard_uid": "string",
"widget_id": "string",
"widget_json": "string"
}Description
Replaces the widget data section. Position (x/y/w/h) is preserved unless explicitly provided.
Prerequisite: Use query_metrics with SHOW MEASUREMENTS and SHOW FIELD KEYS if changing query fields.
Workflow: get_dashboard → edit_dashboard_widget → get_dashboard (verify).Related
What's next?
Last updated on