Datasource Parameters Upsert
datasource_parameters_upsertCreate or replace complete datasource parameter definitions losslessly, preserving roles, defaults, options, validation, and display metadata while guarding writes with fingerprints and preview.
Instructions
Create or replace complete datasource parameter definitions losslessly.
The definition is Data Studio's typed wire from datasource_parameters_list; roles, defaults, options, validation and display metadata are retained exactly. New parameter (Add a parameter): {"parametersModifiedByRoles": [{"key": 1, "value": {"name": K, "dataType": 1 text | 2 number | 4 boolean, "lock": 2, "options": [], "validation": {}, "defaultValue": [{"label": "0.9", "stringValue": "0.9"}]}}, the same under key 2 without label], "parameterDisplayConfiguration": {"name": K, "displayName": "...", "displayType": 1}}; values are strings for every type. Replacing a referenced parameter requires allow_in_use=true. Shared sources need explicit opt-in. Matching draft/published, fingerprint, full-report guard, preview, read-back and operation_restore apply to the datasource-atomic publish.
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>",
"parameters": "<parameters>",
"expected_fingerprint": "<expected_fingerprint>"
},
"name": "datasource_parameters_upsert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| report_id | No | ||
| parameters | Yes | ||
| allow_in_use | No | ||
| datasource_id | Yes | ||
| allow_shared_source | No | ||
| expected_fingerprint | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||