{"type":"api","title":"Remote Firmware Image Upgrade","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/744a8207-9965-344e-aed3-d3ef846a4950","info":{"title":"Others","description":"Other APIs\n- Include APIs that do not belong to other categories\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Configuration - Device Firmware Update"],"description":"Eemote firmware on device","operationId":"remoteFirmwareImageUpgrade","requestBody":{"description":"Request body","content":{"application/json":{"schema":{"type":"object"},"examples":{"Example Value":{"description":"Example Value","value":{"action":"firmwareupgrade","actionName":"firmware_upgrade","actionStart":"Tue Apr 02 2024 09:10:13 UTC","actionStartMillis":1712029213,"actionEnd":"Tue Apr 02 2024 12:10:13 UTC","actionEndMillis":1712040013,"timeZone":"UTC","input":{"data":[{"family":"Teleworker","version":"875d4845-df12-4fdf-91f6-b73c601b2c3f","remoteServerId":"192448a2-36bd-4f50-af04-03b428cd5a8f"}],"versionType":"remote"},"devices":[{"deviceIP":"172.16.255.15","deviceId":"C8K-5c2ed42c-b47e-4155-8000-11c2ddd1f63d"}],"deviceType":"vedge"},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceactionSoftwarepackageFirmwareFirmwareupgradeapiRequestExamplePostfirmwareupgradereq"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","example":"firmwareupgrade"},"actionEnd":{"type":"string","example":"Wed Jan 12 03:00:00 IST 2023"},"actionEndMillis":{"type":"integer","format":"int32","example":1641936600000},"actionName":{"type":"string","example":"firmware_upgrade"},"actionStart":{"type":"string","example":"Tue Jan 11 23:00:00 IST 2023"},"actionStartMillis":{"type":"integer","format":"int32","example":1641922200000},"deviceType":{"type":"string","example":"vedge"},"devices":{"type":"array","items":{"type":"object","properties":{"deviceIP":{"type":"string","example":"40.1.1.1"},"deviceId":{"type":"string","example":"CG113-4GW6B-KWC254402PM"}},"$$ref":"#/components/schemas/FirmwareImageRemoteUpgradeDevices"}},"input":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"family":{"type":"string","example":"Teleworker"},"remoteServerId":{"type":"string","example":"192448a2-36bd-4f50-af04-03b428cd5a8f"},"version":{"type":"string","example":"875d4845-df12-4fdf-91f6-b73c601b2c3f"}},"$$ref":"#/components/schemas/FirmwareImageRemoteUpgradeInputData"}},"versionType":{"type":"string","example":"remote"}},"$$ref":"#/components/schemas/FirmwareImageRemoteUpgradeInput"},"timeZone":{"type":"string","example":"Asia/Kolkata"}},"$$ref":"#/components/schemas/FirmwareImageRemoteUpgrade"},"examples":{"Example":{"description":"Example","value":{"id":"firmware_upgrade-e841dbae-13c2-49b9-9d0f-d5415eaed7f7"},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceactionSoftwarepackageFirmwareFirmwareupgradeapiResponseExamplePostfirmwareupgraderesp"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"post","path":"/device/action/firmware-upgrade"}}