{"type":"api","title":"Update Applications","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/9d37d008417d562ab46d4b67547a68457ce288d2/5477656b-8124-3422-839e-4b90bc91faa4","info":{"title":"Cisco Secure Access App Discovery API","description":"The App Discovery API provides an overall view of application and protocol activity in your environment\nand the potential risk indicated by this network traffic.","version":"2.0.2","contact":{"name":"Cloud Security Developer Community"}},"tags":[{"name":"Applications"},{"name":"Application Categories"},{"name":"Protocols"},{"name":"Identities"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/reports/app-discovery-overview.md","uri":"secure-access-api-reference-app-discovery-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"reports/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"client credential flow","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"reports.appDiscovery:write":"Write reports app discovery","reports.appDiscovery:read":"Read reports app discovery"}}}}}},"spec":{"tags":["Applications","Secure Access"],"summary":"Update Applications","description":"Update the labels for the applications.","operationId":"patchApplications","requestBody":{"description":"A JSON object containing application information for bulk label update.","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","description":"The application label. Valid values are: `unreviewed`, `approved`, `notApproved`, `underAudit`.","enum":["unreviewed","approved","notApproved","underAudit"],"example":"approved","$$ref":"#/components/schemas/Label"},"applicationsList":{"type":"array","description":"Provide a list of application ID to update.","items":{"type":"string"},"minItems":1,"maxItems":1000,"example":["abd1"]}}},"example":{"label":"approved","applicationsList":["1a","2bcsd"]}}},"$$ref":"#/components/requestBodies/BulkApplicationBody"},"security":[{"oauthFlow":["reports.appDiscovery:write"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"The properties of multiple apps that are updated at the same time.","properties":{"timestamp":{"type":"string","description":"The date and time (ISO 8601 timestamp) that the system updated the labels on the applications.","format":"date-time","example":"2022-01-01T00:00:00.000Z"},"number_of_apps":{"type":"integer","description":"The number of apps updated","example":25}},"example":{"timestamp":"2022-01-01T00:00:00.000Z","number_of_apps":45},"$$ref":"#/components/schemas/BulkLabelApplications"},"example":{"timestamp":"2022-01-01T00:00:00.000Z","number_of_apps":45}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/InvalidRequest"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/Unauthorized"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/Forbidden"},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/NotFound"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/ServerError"}},"__originalOperationId":"patchApplications","method":"patch","path":"/appDiscovery/applications"}}