Components Switch Type
components_switch_typeConverts chart components between types or presets with a preview of setting changes. Validates dimensions and metrics, and blocks lossy writes unless allow_loss is set.
Instructions
Convert chart types/presets through isolated native editor transformations.
Preview exposes all changed/removed settings and before/after bindings. Optional dimensions/metrics select source fields or validated expressions before validation; omitted roles retain native conversion, empty lists clear a supported role. Metrics require explicit aggregation; aggregate expressions use AUTO (7). concept_name retains an existing local field ID. Special roles remain separate work. Non-preview writes require allow_loss when settings or fields disappear/change. Same datasource, static ungrouped non-composite charts; conditional formatting remapping and other contexts remain separate work. Requires report_refresh, page_get fingerprint and matching datasource draft/published. One journaled page write/read-back/undo. No claim of equivalent rendering or numeric results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"page_id": "<page_id>",
"changes": "<changes>",
"expected_fingerprint": "<expected_fingerprint>"
},
"name": "components_switch_type"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changes | Yes | ||
| dry_run | No | ||
| page_id | Yes | ||
| report_id | No | ||
| allow_loss | No | ||
| expected_fingerprint | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||