Datasource Refresh Fields
datasource_refresh_fieldsSyncs a datasource's fields with its connector: adds new columns, drops removed ones, and preserves existing field edits. Previews changes by default and blocks removal of fields still in use.
Instructions
Refresh fields from the connector, as the datasource editor's REFRESH FIELDS does.
New columns become fields with the connector's defaults. Fields whose column is gone are removed; if a formula or the report in scope uses one, the refresh is blocked unless allow_in_use=true. Surviving fields keep every edit (labels, types, aggregation, descriptions); a column whose type changed is listed in retyped_columns, not retyped. Preview by default; publication is journaled, read back and reversible with operation_restore. Single-connector sources only.
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": {
"datasource_id": "<datasource_id>",
"expected_fingerprint": "<expected_fingerprint>"
},
"name": "datasource_refresh_fields"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| report_id | No | ||
| allow_in_use | No | ||
| datasource_id | Yes | ||
| allow_shared_source | No | ||
| expected_fingerprint | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||