set_return_device_parameter
Set a device parameter on a return track by return and device index and parameter name/index. Values can be native numbers, enum labels, or unit strings like '250 Hz'; out-of-range values are clamped.
Instructions
Set one enabled parameter on a device in a return track's chain.
Call get_return_device_parameters first and use its parameter name/index and native min/max; numeric out-of-range values are clamped. Supported display-unit strings and exact enum labels also work; unsupported mappings fail before writing. Use set_device_parameter for a regular track or set_master_device_parameter for the full-mix chain.
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": {
"return_index": "<return_index>",
"device_index": "<device_index>",
"parameter": "<parameter>",
"value": "<value>"
},
"name": "set_return_device_parameter"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | Native number (clamped/quantized), exact enum label, or display text with Hz/kHz/ms/s/dB/% units, e.g. '250 Hz'. Unsupported mappings fail before writing. | |
| parameter | Yes | Parameter name or zero-based parameter index returned by the matching get_*_device_parameters tool. | |
| device_index | Yes | Zero-based device position in the target track's device chain. | |
| return_index | Yes | Zero-based return-track index; 0 is Return A. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |