set_parameter
Set TR-069 parameter values on a CPE device to change configurations such as WiFi SSID or management server URL. Queues the task and sends a connection request for immediate execution.
Instructions
Set one or more TR-069 parameter values on a CPE device through GenieACS. Use this tool to change device configuration such as WiFi SSID, management server URL, periodic inform interval, or any writable TR-069 parameter. The parameter_values argument must be a JSON array of tuples, where each tuple is [parameterPath, value] or [parameterPath, value, xsdType]. Example: [["InternetGatewayDevice.LANDevice.1.WLANConfiguration.1.SSID","MySSID","xsd:string"]]. Valid xsd types include xsd:string, xsd:boolean, xsd:unsignedInt, xsd:int, xsd:dateTime. If the type is omitted, GenieACS infers it from the value. The task is queued and a connection request is sent to the CPE for immediate execution. Returns the raw ACS JSON response confirming the task. Limitations: the CPE must be reachable for immediate execution; otherwise the task remains queued until the next periodic inform. Not all parameters are writable — the CPE will fault if you attempt to set a read-only parameter. Use refresh_parameter or genieacs://device/{id} first to discover valid parameter paths.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_id | Yes | The exact GenieACS device identifier (_id field). Typically in the format OUI-ProductClass-SerialNumber (e.g. "00236A-SmartRG585-SMRT00236a42"). Obtain valid IDs from the genieacs://devices/list resource. | |
| parameter_values | Yes | A JSON array of parameter tuples to set. Each tuple is either [path, value] or [path, value, xsdType]. Example: [["Device.WiFi.SSID.1.SSID","NewName","xsd:string"],["Device.ManagementServer.PeriodicInformInterval",300,"xsd:unsignedInt"]] |