Components Filters
components_filtersSet saved filter bindings and inheritance on page components, with optional clearing, validation, and preview before applying changes.
Instructions
Set saved filter bindings and inheritance on components within one page.
Each change: component_id, optional filter_ids (complete ordered list; [] clears local bindings), optional inherit_filters. Omitted/null properties stay unchanged. Get fingerprints from page_get and filters_list; refresh the viewer before preparation. Native component-schema validation rejects incompatible filters; direct attached datasources with matching draft/published required. Does not create/delete resources or mutate viewer control selections. Page journal/read-back/undo also guard report resource changes. Not a cross- entity transaction or proof of query results. Page/group/report-level binding and blend datasets need their own operations. Preview by default; no publication.
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_page_fingerprint": "<expected_page_fingerprint>",
"expected_report_content_fingerprint": "<expected_report_content_fingerprint>"
},
"name": "components_filters"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changes | Yes | ||
| dry_run | No | ||
| page_id | Yes | ||
| report_id | No | ||
| expected_page_fingerprint | Yes | ||
| expected_report_content_fingerprint | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||