update_settings
Update a Horizon VDI settings section by reading current values, changing only intended fields, and saving. For general settings, add version to restricted_client_data entries to avoid errors.
Instructions
Update a Horizon settings section.
setting_type maps to these resources and endpoints: general → horizon://config/settings/general security → horizon://config/settings/security client → horizon://config/settings/client feature → horizon://config/settings/feature agent-restriction → horizon://config/settings/agent-restriction
Always read the current settings first and only modify the fields you intend to change.
general: Horizon returns restricted_client_data entries that have only a "type", but rejects them on update with "Restricted client version must be set for client type " (verified on 2606), so passing the settings back unchanged fails. Give every restricted_client_data entry a "version" before calling this.
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": {
"setting_type": "<setting_type>",
"spec": "<spec>"
},
"name": "update_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spec | Yes | Updated settings object. Read current values first, modify only the fields you intend to change, then pass the full object here. | |
| confirm | No | Only used when the server runs with HORIZON_CONFIRMATION=flag (clients without elicitation). Otherwise the user is asked to confirm directly in the client. | |
| setting_type | Yes | Settings section to update. Read current values via the corresponding horizon://config/settings/<type> resource before modifying. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||