{"type":"api","title":"Delete Control Component Device Specific Settings","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":"Delete the device-specific settings for a specific control component. The deviceId can be obtained from the \"uuid\" field in the data returned by the API (GET /dataservice/certificate/data/controller/list)","operationId":"deleteControlComponentDeviceSpecificSettings","parameters":[{"name":"deviceId","in":"path","description":"Control component device UUID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success"},"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":{"DeleteControlComponentDeviceSpecificSettingsFailed":{"description":"DeleteControlComponentDeviceSpecificSettingsFailed","value":{"error":{"message":"Failed to delete the device specific settings for specific control component","code":"CCS0008","details":"Control component is deployed with current settings, can't remove device specific settings, change control component to CLI mode and retry later","type":"error"}},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceconfigControlcomponentSettingResponseExampleDeletedevicespecificsettingsfailedresponse"}}}}},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Control Component Settings-write","method":"delete","path":"/v1/control-component/devices/{deviceId}/settings"}}