{"type":"api","title":"Update Classification for Application","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/83e8a10367d157243cd1c3e478b807cb81262a3d/eadd0b56-ea60-32bd-a1aa-155c29b52bed","info":{"title":"Cisco Cloudlock API","description":"The Cloudlock API provides data about an organization's activities, apps, incidents, and policies.","version":"1.0.0","contact":{"name":"Cloud Security Developer Community"}},"tags":[{"name":"Activities"},{"name":"Apps"},{"name":"Entities"},{"name":"Incidents"},{"name":"Incident Aggregates"},{"name":"Incident Entities"},{"name":"IP Libraries"},{"name":"Policies"}],"openapi":"3.0.0","servers":[{"url":"https://api.cloudlock.com/api/v2"}]},"spec":{"tags":["Apps"],"description":"Update the application's classification.","summary":"Update Classification for Application","operationId":"updateAppsClassification","parameters":[{"description":"The ID of the incident.","example":"Aj54oPkx8m","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"example":{"other_reason":"Other Custom Reason","reason_id":4,"type":"trusted"},"properties":{"other_reason":{"type":"string"},"reason_id":{"type":"number"},"type":{"type":"string"}},"type":"object"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The application's internal CloudLock ID."},"app":{"type":"object","description":"The information about the application.","properties":{"category":{"type":"string","description":"The app's category."},"id":{"type":"string","description":"The internal Cloudlock id for the application."},"install_type":{"type":"string","description":"A string that describes the installation type (across the domain or by a user). Possible values are: domain_wide, user."},"is_revokable":{"type":"boolean","description":"Indicates whether the app can be revoked."},"name":{"type":"string","description":"The name of the application, for example: Google Drive."},"origin_id":{"type":"string","description":"The location where the app was installed."},"trust_rating":{"type":"string","description":"The community trust rating score."},"vendor":{"type":"object","properties":{"name":{"type":"string","description":"The name of the vendor. For example: google."}},"$$ref":"#/components/schemas/Vendor"}},"$$ref":"#/components/schemas/App"},"scope_categories":{"type":"array","items":{"type":"object","description":"The scope categories resource returns information on the access scopes, which exist per each category.\nScope category strings: `FDATA` (full data access), `BINFO` (basic info), `LACES` (limited access to data and files),\n`PINFO` (payment information), and `INBO`X (access inbox or contact information).","properties":{"title":{"type":"string","description":"The categories title, for example: `Basic Information`."},"category_id":{"type":"string","description":"The category id. For example: `FDATA`, `BINFO`, `LACES`, and `PINFO`.","example":"FDATA"}},"$$ref":"#/components/schemas/ScopeCategory"},"description":"The list of application scope category."},"classification":{"type":"object","properties":{"method":{"type":"string","description":"The method where the classification was changed. Possible values are: manual, policy."},"reason":{"type":"string","description":"The reason for the classification."},"type":{"type":"string","description":"Application's classification type. Possible values are: unclassified, trusted, restricted, banned."},"updated_at":{"type":"string","description":"The classification's last update time, specified as a timestamp in UTC."}},"description":"The application's classification resource.","$$ref":"#/components/schemas/Classification"},"detected_at":{"type":"string","description":"The time when the app was detected, specified as a timestamp in UTC."},"users_count":{"type":"integer","description":"The number of users that have the application installed."},"admins_count":{"type":"integer","description":"The number of administrators that have the application installed."}},"$$ref":"#/components/schemas/AppsCollection"}},"examples":{"response":{"value":[{"app1":null,"app":{"category":"","id":"Aj54oPkx8m","install_type":"user","is_revokable":true,"name":"CloudLock Collaboration Security","origin_id":"150079143025-d1lebr0q2pdf3i9vp2o3gb9dhm6nahq1.apps.googleusercontent.com","vendor":{"name":"google"}},"classification":{"method":"manual","other_reason":"Other Custom Reason","reason":"Internal reason","reason_id":4,"type":"trusted"},"updated_at":"2016-01-17T20:43:08.465267+00:00","detected_at":"2015-04-13T11:54:47.403000+00:00","id":"Aj54oPkx8m","scope_categories":[{"category_id":"BINFO"}],"users_count":1}]}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/400Error"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/401Error"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/403Error"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/404Error"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"$$ref":"#/components/responses/500Error"}},"__originalOperationId":"updateAppsClassification","method":"post","path":"/apps/{id}/classification"}}