{"type":"api","title":"Reschedule controllers upgrade process","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":["Workflows - Controllers Upgrade"],"summary":"Reschedule controllers upgrade process.","description":"Reschedule the upgrade process for managers, validators, and controllers by providing new execution timestamps.","operationId":"rescheduleUpgrade","requestBody":{"description":"Request payload for controllers upgrade","content":{"application/json":{"schema":{"required":["isScheduleNow","processId"],"type":"object","properties":{"isScheduleNow":{"type":"boolean","description":"Flag to schedule the upgrade immediately","example":false},"processId":{"type":"string","description":"Unique ID of the upgrade process","example":"controllers_upgrade-61fe5fb4-81d2-4ff0-8294-e23c17b0d79e"},"schedule":{"type":"object","additionalProperties":{"type":"object","properties":{"actionStartDate":{"type":"string","description":"Start date for the action","example":"Sep 30 2026"},"actionStartTime":{"type":"string","description":"Start time for the action","example":"12:00:00 AM"},"timeZone":{"type":"string","description":"Timezone for the scheduled action","example":"Asia/Kolkata"}},"description":"Scheduling details for a controller component","$$ref":"#/components/schemas/ComponentSchedule"},"description":"Scheduling details for different component types"}},"description":"Request payload for rescheduling controller upgrade process","$$ref":"#/components/schemas/ControllerUpgradeRescheduleRequest"},"examples":{"Request Payload - Controllers":{"description":"Request Payload - Controllers","value":{"processId":"controllers_upgrade-61fe5fb4-81d2-4ff0-8294-e23c17b0d79e","isScheduleNow":false,"schedule":{"Controller":{"actionStartDate":"Sep 30 2026","actionStartTime":"12:00:00 AM","timeZone":"Asia/Kolkata"},"Manager":{"actionStartDate":"Sep 30 2026","actionStartTime":"12:00:00 AM","timeZone":"Asia/Kolkata"},"Validator":{"actionStartDate":"Sep 30 2026","actionStartTime":"12:00:00 AM","timeZone":"Asia/Kolkata"}}}},"Request Payload - Patch":{"description":"Request Payload - Patch","value":{"processId":"controllers_patch_upgrade-61fe5fb4-81d2-4ff0-8294-e23c17b0d79e","isScheduleNow":false,"schedule":{"Validator":{"actionStartDate":"Sep 30 2026","actionStartTime":"12:00:00 AM","timeZone":"Asia/Kolkata"}}}},"Request Payload - Schedule Now":{"description":"Request Payload - Schedule Now","value":{"processId":"controllers_upgrade-61fe5fb4-81d2-4ff0-8294-e23c17b0d79e","isScheduleNow":true}}}}},"required":true},"responses":{"200":{"description":"Successfully rescheduled the upgrade process","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Status of the operation (Cancel/Reschedule)"},"statusDetail":{"type":"string","description":"Detailed description of the operation (Cancel/Reschedule) result"}},"$$ref":"#/components/schemas/ControllersOperationResponse"},"examples":{"Response Payload":{"description":"Response Payload","value":{"status":"Success","statusDetail":"Upgrade process successfully rescheduled"}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"404":{"description":"Transaction not found"},"500":{"description":"Internal Server Error"}},"method":"put","path":"/v1/controllers-upgrade/reschedule"}}