previous, the values the change replaced, so the change can be undone.
If your client does not list this tool, it is not available on your connection: the connection is read-only, or your role in the Space is Viewer (or no longer allows changes).
When to use
- “Make that a bar chart.”
- “Use the last 90 days.”
- “Add cost per lead to the campaign table.”
Parameters
Semantics
- A field you leave out of
changeskeeps its value. - An array field (
metrics,group_by,sources) is replaced as a whole, so pass the complete new list. optionsis merged key by key. Withoptions_mode: "replace"inchanges, theoptionsyou pass become the report’s options exactly.- A change of type, metrics or grouping gives the report the display options that suit its new shape. Any other change (a name, a period, a source) leaves the report’s look as it was.
- A
date_rangethe server doesn’t know, or a range sent without the dates it needs, is saved aslast_30_days. Checkdate_rangein the response.
Example
Request:Undo
previous holds every field the update changed, as it was before, including fields that changed as a consequence (the dates of a custom range, the display options of the old shape). When the display options changed, previous carries the old options whole with options_mode: "replace".
To undo a change, call update_dashboard_report again with the same report_id and previous as changes, unmodified.
Errors
not_foundwhen no dashboard in this Space has a report with that ID, including reports in other Spaces.- A config that cannot render returns a
validation_errorwith the field named, and the report stays as it was.
Caveats
- Not available to read-only connections, which include every connection made by a Viewer: the tool is hidden and calling it returns “Tool not found”.
- The call changes your Cometly data only. It makes no outbound request, touches no ad platform and uses no AI credits.
- Deleting a report, moving it to another dashboard, and moving or resizing its tile are not possible through MCP. Do those in Cometly.