{"type":"api","title":"List Installations of Application","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/9d37d008417d562ab46d4b67547a68457ce288d2/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":"List the application's installations.","operationId":"listApplicationInstallations","summary":"List Installations of Application","parameters":[{"description":"The ID of the app.","example":"G8qz0A239V","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"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":[{"response":{"app":{"id":"rNP3DKdzBy","install_type":"user","name":"Balsamiq Mockups 3 for Google Drive","origin_id":"199991064517-4p9fkqt42jbsg361b4lu8fsuob161vhn.apps.googleusercontent.com","access_risk":2,"is_revokable":true,"category":"","client_type":"not_native","risk_level":1,"trust_rating":100},"vendor":{"name":"google"},"detection_date":"2015-04-07T07:42:11.452682+00:00","domain":"cloudlockplus.com","family_name":"Admin","given_name":"Admin","scope_id":15926475,"scope_type":"user","scope_value":"admin@cloudlockplus.com","state":"not_installed"}}]}}}}},"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":"listApplicationInstallations","method":"get","path":"/apps/{id}/installs"}}