{"type":"api","title":"Update one preset property","meta":{"id":"/apps/pubhub/media/cyber-vision-5-3/e889ca86e22c7a47e33bc1438ffdba51f3384493/262737b2-b3c2-32cd-b07b-fdbdcd23918f","info":{"description":"RESTful API to manage the resources of Cisco Cyber Vision centers.","title":"Cisco Cyber Vision center v3 API.","version":"3.0.0-5.3.0"},"security":[{"token":[]}],"tags":[{"description":"Routes to configure the Active Discovery mode.","name":"ActiveDiscovery"},{"description":"Activities are an aggregation of flows between components.","name":"Activities"},{"description":"In monitor mode, these routes allow to retrieve and review differences between the actual network activity and the baseline description.","name":"BaselineDifferences"},{"description":"A baseline is used for monitor mode. They represent a snapshot of the network.","name":"Baselines"},{"description":"Components are logical nodes of the network.","name":"Components"},{"description":"Routes to manage network organization.","name":"CustomNetwork"},{"description":"Routes to manage custom properties that can be added to components or groups.","name":"CustomProperties"},{"description":"Routes to retrieve statistics and dashboard information. ","name":"Dashboard"},{"description":"Routes to retrieve information about the sensor deployment tokens.","name":"Deployments"},{"description":"A Device is a physical device that host a software that communicates on the network","name":"Devices"},{"description":"Routes to retrieve about external communications.","name":"ExternalCommunication"},{"description":"Flows represent a network interaction between two components.","name":"Flows"},{"description":"Routes to retrieve information about the global credentials.","name":"GlobalCredentials"},{"description":"Routes to get a graphical representation of the components, activities, etc.","name":"Graph"},{"description":"Groups are a logical way to organize components.","name":"Groups"},{"description":"Various routes to get more information about a center.","name":"Misc"},{"description":"Routes to access the application parameters such as security options and allow to manage custom parameters.","name":"Parameters"},{"description":"Routes to retrieve information about pcap files replayed.","name":"PcapReplays"},{"description":"Presets are a way to filter data and prepare visualizations.","name":"Presets"},{"description":"Preset Based Reports","name":"Reports"},{"description":"Routes to access the configuration of the risk scores.","name":"RiskScores"},{"description":"Routes to browse sensor folders.","name":"SensorExplorer"},{"description":"Routes to retrieve information about the enrolled sensors.","name":"Sensors"},{"description":"Routes to retrieve information about the sensor templates.","name":"SensorTemplates"},{"description":"Tags are meaningful labels applied to components and activities to describe network behaviors and device properties.","name":"Tags"},{"description":"Vulnerabilities are known security threats that could allow an attacker to gain unauthorized privileges.","name":"Vulnerabilities"}],"x-parser-conf":{"overview":{"markdownPath":"reference/overview.md"}},"swagger":"2.0","basePath":"/api/3.0/","schemes":["https"],"securityDefinitions":{"token":{"description":"API token created in the Cyber Vision administration UI","type":"apiKey","name":"x-token-id","in":"header"}}},"spec":{"description":"Update one preset property. For the moment, add and remove on components are implemented. For more information, see https://tools.ietf.org/html/rfc6902","tags":["Presets"],"summary":"Update one preset property.","operationId":"patchPreset","parameters":[{"type":"string","description":"preset id (uuid)","name":"preset_id","in":"path","required":true},{"description":"partial update payload. accepted \"op\" is \"set\". accepted path are \"/name\" (or \"/label\"), \"/description\" and \"/search\"","name":"preset","in":"body","schema":{"description":"see https://tools.ietf.org/html/rfc6902 for more information","type":"object","title":"PartialUpdate is used to update partially an Entity.","properties":{"op":{"type":"string","x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3/payload","$$ref":"#/definitions/PartialUpdateOperation"},"path":{"type":"string","x-go-name":"Path"},"value":{"type":"array","items":{"type":"string"},"x-go-name":"Value"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3/payload","$$ref":"#/definitions/PartialUpdate"}}],"responses":{"200":{"description":"updated group","schema":{"description":"Group detail json representation","type":"object","properties":{"activitiesCount":{"type":"integer","format":"int64","x-go-name":"ActivitiesCount"},"ancestors":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","x-go-name":"Color"},"criticalness":{"type":"integer","format":"int64","x-go-name":"Criticalness"},"depth":{"type":"integer","format":"int64","x-go-name":"Depth"},"id":{"type":"string","x-go-name":"Id"},"label":{"type":"string","x-go-name":"Label"},"locked":{"type":"boolean","x-go-name":"Locked"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/GroupAncestor"},"x-go-name":"Ancestors"},"centerID":{"type":"string","x-go-name":"CenterID"},"color":{"type":"string","x-go-name":"Color"},"comments":{"type":"string","x-go-name":"Comments"},"componentIds":{"type":"array","items":{"type":"string"},"x-go-name":"ComponentIds"},"componentsTags":{"type":"array","items":{"type":"object","properties":{"category":{"description":"Category json representation","type":"object","properties":{"id":{"type":"string","x-go-name":"Id"},"label":{"type":"string","x-go-name":"Label"},"priority_order":{"type":"integer","format":"int64","x-go-name":"PriorityOrder"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/Category"},"id":{"type":"string","x-go-name":"Id"},"important":{"type":"boolean","x-go-name":"Important"},"label":{"type":"string","x-go-name":"Label"},"type":{"type":"string","x-go-name":"Type"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/Tag"},"x-go-name":"ComponentsTags"},"criticalness":{"type":"integer","format":"int64","x-go-name":"Criticalness"},"description":{"type":"string","x-go-name":"Description"},"deviceIds":{"type":"array","items":{"type":"string"},"x-go-name":"DeviceIds"},"devicesCount":{"type":"integer","format":"int64","x-go-name":"DevicesCount"},"eventsCount":{"type":"integer","format":"int64","x-go-name":"EventsCount"},"flowsTags":{"type":"array","items":{"type":"object","properties":{"category":{"description":"Category json representation","type":"object","properties":{"id":{"type":"string","x-go-name":"Id"},"label":{"type":"string","x-go-name":"Label"},"priority_order":{"type":"integer","format":"int64","x-go-name":"PriorityOrder"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/Category"},"id":{"type":"string","x-go-name":"Id"},"important":{"type":"boolean","x-go-name":"Important"},"label":{"type":"string","x-go-name":"Label"},"type":{"type":"string","x-go-name":"Type"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/Tag"},"x-go-name":"FlowsTags"},"groupIds":{"type":"array","items":{"type":"string"},"x-go-name":"GroupIds"},"id":{"type":"string","x-go-name":"Id"},"label":{"type":"string","x-go-name":"Label"},"locked":{"type":"boolean","x-go-name":"Locked"},"parentId":{"type":"string","x-go-name":"ParentId"},"userProperties":{"type":"array","items":{"description":"ExtraField json representation","type":"object","properties":{"id":{"type":"string","x-go-name":"Id"},"label":{"type":"string","x-go-name":"Label"},"value":{"type":"string","x-go-name":"Value"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/ExtraField"},"x-go-name":"Fields"},"vulnerabilitiesCount":{"type":"integer","format":"int64","x-go-name":"VulnerabilitiesCount"}},"x-go-package":"cv-gitlab.cisco.com/sentryo-labs/ccv-go/backend/serialization/v3","$$ref":"#/definitions/GroupDetail"}},"400":{"description":"bad request. payload in unexpected format, less than 1 or more than 2 patches"},"401":{"description":"incorrect token"},"403":{"description":"forbidden. The \"path\" is not allowed"},"404":{"description":"No preset found."},"412":{"description":"precondition failed on some field of the body (too long)"},"default":{"description":"unexpected error"}},"__originalOperationId":"patchPreset","consumes":["application/json"],"produces":["application/json"],"security":[{"token":[]}],"method":"patch","path":"/presets/{preset_id}"}}