{"type":"api","title":"Deploy Control Component Settings To Device","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 - Control Component Setting"],"description":"Deploy control component settings to one or multiple control component devices","operationId":"deployControlComponentSettingsToDevice","requestBody":{"description":"Deploy settings to control components","content":{"application/json":{"schema":{"required":["devices"],"type":"object","properties":{"devices":{"maxItems":2147483647,"minItems":1,"type":"array","description":"Control Component device UUID list","items":{"required":["id"],"type":"object","properties":{"id":{"pattern":"^[a-zA-Z0-9\\-/]+$","type":"string","description":"Control Component device UUID","example":"48844743-8f58-4fff-845a-e54ec27340f5"}},"description":"Control Component device UUID","$$ref":"#/components/schemas/ControlComponentDeviceId"}}},"description":"Deploy control component setting to multiple control component devices","$$ref":"#/components/schemas/ControlComponentDeployRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"required":["id"],"type":"object","properties":{"id":{"type":"string","description":"Task ID","example":"deploy_control_component_setting-da0ca791-8a3f-4cec-9d14-f4102d6364a1"}},"description":"Return the task ID for the deploy operation","$$ref":"#/components/schemas/ControlComponentDeviceDeployResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"required":["error"],"type":"object","properties":{"error":{"required":["code","details","message","type"],"type":"object","properties":{"code":{"type":"string","description":"Internal error code","example":"CCS0018"},"details":{"type":"string","description":"Error message detail","example":"Unrecognized field user1"},"message":{"type":"string","description":"Error message summary","example":"Invalid control component setting payload"},"type":{"type":"string","description":"Error message title","example":"error"}},"description":"Error response","$$ref":"#/components/schemas/ErrorDetails"}},"$$ref":"#/components/schemas/ErrorResponse"},"examples":{"DeployControlComponentDeviceFailed":{"description":"DeployControlComponentDeviceFailed","value":{"error":{"message":"Deploy control component setting to device failed","code":"CCS0019","details":"Device daaa0139-4572-4373-9fd9-f6620c1368e3 is already deploying in-progress","type":"error"}},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceconfigControlcomponentSettingResponseExampleDeploycontrolcomponentfailedresponse"}}}}},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Control Component Settings-write","method":"post","path":"/v1/control-component/devices/settings/deploy"}}