Applications
SaaS: Applications (1.4.1)
Download OpenAPI specification:Download
API for interacting with SaaS applications.
Get applications
Returns the details of a list of applications.
Authorizations:
query Parameters
page_number | integer <int32> Default: 1 The page number. |
page_size | integer <int32> Default: 100 The maximum number of items in the response. |
filter | string Example: filter=?filter=field1 -eq 'abc' For more information on the available operators and which data types those operators work on, see Filter API call results. |
sort | string Example: sort=?sort=field1:asc For more information on sorting capability and examples, see Sort API call results. |
Responses
Response samples
- 200
- 400
- 500
{- "items": [
- {
- "id": "19bb4eb7-3012-435a-9845-55626ef40460",
- "name": "Teams",
- "vendor": "Microsoft Corp.",
- "vendorId": "365540e0-3150-48b9-9841-dbff43925065",
- "licenses": [
- {
- "id": "e2e901ba-ad57-4433-a6ba-50178134852a",
- "total": 32,
- "assigned": 27,
- "productId": "6a24e288-03f2-4237-8f1e-d6ed4e1ea0f4",
- "collectionTargetId": "4770a19c-c789-4c10-82dd-062a4a23d6bb"
}
], - "licenseCount": 10,
- "total": 25,
- "purchased": 12,
- "available": 13,
- "yearlyCost": 6.45,
- "assigned": 5,
- "active": 11,
- "bundle": true,
- "inactive": 7,
- "utilization": 76.98,
- "totalUniqueUsers": 21,
- "discoveryTypes": [
- 1
], - "discoveryDate": "2024-10-01",
- "discoverySource": "Manual.",
- "categoryName": "Digital Content Editing Platform",
- "primaryOwnerId": "906b7a69-597e-4e13-bbda-5fb2dd903cc6",
- "primaryOwnerName": "Ryan Renolds",
- "sanctioned": true,
- "singleSignOn": true,
- "notes": "Notes about Illustrator.",
- "disServiceId": "a1a6f610-3a09-4ae4-87a0-7d4bf6218962",
- "totalUniqueUsersFromActivities": 12,
- "description": "Illustrator CC is a vector graphics editor and design program used by professionals to create digital graphics, illustrations, and typography. It is part of the Adobe Creative Cloud suite and is widely used for creating high-quality artwork for various me.",
- "aiCategory": "Graphic Design",
- "aiSubcategory": "Vector Graphic Design",
- "riskScore": 5,
- "certifications": {
- "0": "SOC1",
- "1": "ISO27001"
}
}
], - "pagination": {
- "page_size": 100,
- "page_number": 1,
- "total_pages": 1,
- "total_items": 1
}
}
Get application
Returns the details of an application.
Authorizations:
path Parameters
applicationId required | string The unique ID of the application. |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "id": "19bb4eb7-3012-435a-9845-55626ef40460",
- "name": "Teams",
- "vendor": "Microsoft Corp.",
- "vendorId": "365540e0-3150-48b9-9841-dbff43925065",
- "licenses": [
- {
- "id": "e2e901ba-ad57-4433-a6ba-50178134852a",
- "total": 32,
- "assigned": 27,
- "productId": "6a24e288-03f2-4237-8f1e-d6ed4e1ea0f4",
- "collectionTargetId": "4770a19c-c789-4c10-82dd-062a4a23d6bb"
}
], - "licenseCount": 10,
- "total": 25,
- "purchased": 12,
- "available": 13,
- "yearlyCost": 6.45,
- "assigned": 5,
- "active": 11,
- "bundle": true,
- "inactive": 7,
- "utilization": 76.98,
- "totalUniqueUsers": 21,
- "discoveryTypes": [
- 1
], - "discoveryDate": "2024-10-01",
- "discoverySource": "Manual.",
- "categoryName": "Digital Content Editing Platform",
- "primaryOwnerId": "906b7a69-597e-4e13-bbda-5fb2dd903cc6",
- "primaryOwnerName": "Ryan Renolds",
- "sanctioned": true,
- "singleSignOn": true,
- "notes": "Notes about Illustrator.",
- "disServiceId": "a1a6f610-3a09-4ae4-87a0-7d4bf6218962",
- "totalUniqueUsersFromActivities": 12,
- "description": "Illustrator CC is a vector graphics editor and design program used by professionals to create digital graphics, illustrations, and typography. It is part of the Adobe Creative Cloud suite and is widely used for creating high-quality artwork for various me.",
- "aiCategory": "Graphic Design",
- "aiSubcategory": "Vector Graphic Design",
- "riskScore": 5,
- "certifications": {
- "0": "SOC1",
- "1": "ISO27001"
}
}
Update application
Modifies an application.
Authorizations:
path Parameters
applicationId required | string The unique ID of the application. |
Request Body schema: application/merge-patch+jsonrequired
An application to be updated.
primaryOwnerId required | string The unique ID of the primary owner. | ||||||
sanctioned required | boolean
| ||||||
singleSignOn required | boolean
| ||||||
notes required | string Notes about the application. | ||||||
description required | string Description of the application. | ||||||
aiCategory required | string AI category of the application. | ||||||
aiSubcategory required | string AI sub-category of the application. | ||||||
required | object (ApplicationPatchWebsite) | ||||||
|
Responses
Request samples
- Payload
{- "primaryOwnerId": "906b7a69-597e-4e13-bbda-5fb2dd903cc6",
- "sanctioned": true,
- "singleSignOn": true,
- "notes": "Notes about Illustrator.",
- "description": "Illustrator CC is a vector graphics editor and design program used by professionals to create digital graphics, illustrations, and typography. It is part of the Adobe Creative Cloud suite and is widely used for creating high-quality artwork for various me.",
- "aiCategory": "Graphic Design",
- "aiSubcategory": "Vector Graphic Design",
- "websiteDate": {
- "categoryName": "Digital Content Editing Platform"
}
}
Response samples
- 200
- 400
- 404
- 500
{- "id": "19bb4eb7-3012-435a-9845-55626ef40460",
- "name": "Teams",
- "vendor": "Microsoft Corp.",
- "vendorId": "365540e0-3150-48b9-9841-dbff43925065",
- "licenses": [
- {
- "id": "e2e901ba-ad57-4433-a6ba-50178134852a",
- "total": 32,
- "assigned": 27,
- "productId": "6a24e288-03f2-4237-8f1e-d6ed4e1ea0f4",
- "collectionTargetId": "4770a19c-c789-4c10-82dd-062a4a23d6bb"
}
], - "licenseCount": 10,
- "total": 25,
- "purchased": 12,
- "available": 13,
- "yearlyCost": 6.45,
- "assigned": 5,
- "active": 11,
- "bundle": true,
- "inactive": 7,
- "utilization": 76.98,
- "totalUniqueUsers": 21,
- "discoveryTypes": [
- 1
], - "discoveryDate": "2024-10-01",
- "discoverySource": "Manual.",
- "categoryName": "Digital Content Editing Platform",
- "primaryOwnerId": "906b7a69-597e-4e13-bbda-5fb2dd903cc6",
- "primaryOwnerName": "Ryan Renolds",
- "sanctioned": true,
- "singleSignOn": true,
- "notes": "Notes about Illustrator.",
- "disServiceId": "a1a6f610-3a09-4ae4-87a0-7d4bf6218962",
- "totalUniqueUsersFromActivities": 12,
- "description": "Illustrator CC is a vector graphics editor and design program used by professionals to create digital graphics, illustrations, and typography. It is part of the Adobe Creative Cloud suite and is widely used for creating high-quality artwork for various me.",
- "aiCategory": "Graphic Design",
- "aiSubcategory": "Vector Graphic Design",
- "riskScore": 5,
- "certifications": {
- "0": "SOC1",
- "1": "ISO27001"
}
}
Get application KPIs
Returns the details of an applications KPIs.
Authorizations:
path Parameters
applicationId required | string The unique ID of the application. |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "id": "e5ea6f20-47ad-41be-a3c5-839409d89791",
- "monthlyCost": {
- "value30DaysAgo": 20,
- "valueCurrent": 10
}, - "subscriptionTypes": {
- "value30DaysAgo": 20,
- "valueCurrent": 10
}, - "subscriptions": {
- "value30DaysAgo": 20,
- "valueCurrent": 10
}, - "totalUsers": {
- "value30DaysAgo": 20,
- "valueCurrent": 10
}, - "unassignedSubscriptions": {
- "value30DaysAgo": 20,
- "valueCurrent": 10
}
}
Get applications overview KPIs
Returns the details of the applications overview key performance indicators.
Authorizations:
query Parameters
fromDate required | string <date> Example: fromDate=2024-11-26 Starting date from which to calculate KPI. |
toDate required | string <date> Example: toDate=2024-11-26 Starting date until which to calculate KPI. |
Responses
Response samples
- 200
- 400
- 500
{- "applicationDiscoveryLastSevenDays": [
- {
- "browserMeteringCount": 250,
- "connectorCount": 250,
- "date": "2024-03-04T14:07:14.755837Z",
- "deviceCount": 250,
- "manuallyAddedCount": 250,
- "ssoCount": 250
}
], - "notApproved": { },
- "total": [
- {
- "trend": -1000,
- "value": 250
}
]
}
Get applications KPIs
Returns the details of the KPIs for all applications.
Authorizations:
query Parameters
fromDate required | string <date> Example: fromDate=2024-11-26 Starting date from which to calculate KPI. |
toDate required | string <date> Example: toDate=2024-11-26 Starting date until which to calculate KPI. |
Responses
Response samples
- 200
- 400
- 500
{- "totalApplications": 15,
- "totalApplicationsTrend": 7,
- "unsanctioned": 2,
- "appCategories": [
- {
- "name": "Communication",
- "total": 10
}
], - "aiAppCategories": [
- {
- "name": "Communication",
- "total": 10
}
], - "appCategoriesUnsanctioned": [
- {
- "name": "Communication",
- "total": 10
}
], - "aiAppCategoriesUnsanctioned": [
- {
- "name": "Communication",
- "total": 10
}
], - "activeUserApplications": [
- {
- "name": "Communication",
- "totalUsers": 10
}
], - "activeUserApplicationsUnsanctioned": [
- {
- "name": "Communication",
- "totalUsers": 10
}
]
}
Get application users
Returns a collection of users assigned to an application.
Authorizations:
path Parameters
applicationId required | string The unique ID of the application. |
query Parameters
page_number | integer <int32> Default: 1 The page number. |
page_size | integer <int32> Default: 100 The maximum number of items in the response. |
filter | string Example: filter=?filter=field1 -eq 'abc' For more information on the available operators and which data types those operators work on, see Filter API call results. |
sort | string Example: sort=?sort=field1:asc For more information on sorting capability and examples, see Sort API call results. |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "pagination": {
- "page_size": 100,
- "page_number": 1,
- "total_pages": 1,
- "total_items": 1
}, - "items": [
- {
- "country": "Japan",
- "createdDate": "2024-05-25T00:00:00Z",
- "department": "Engineering",
- "discoveryTypes": {
- "0": 1,
- "1": 2
}, - "displayName": "John Doe",
- "email": "john.doe@organization.com",
- "id": "2f86b198-04f3-4770-ad08-b32518206da0",
- "isEnabled": true,
- "isInReview": true,
- "isOnline": true,
- "isQualified": true,
- "lastActive": "2024-06-28T00:00:00Z",
- "licenseCount": 5,
- "potentialSavings": 500,
- "status": "Active",
- "userCostPerMonth": 1000,
- "username": "john.doe_1@org.com",
- "totalDaysUsed": 10,
- "employmentStatus": "Employed",
- "hireDate": "2024-06-28T00:00:00Z",
- "terminationDate": "2024-06-28T00:00:00Z",
- "roles": [
- "Role1"
]
}
]
}
Bulk update applications
Modifies a collection of application properties the provided applications.
Authorizations:
Request Body schema: application/json
filter | string For more information on the available operators and which data types those operators work on, see Filter API call results. | ||||||||
scope required | string
The scope of the update operation. | ||||||||
ids | Array of strings The IDs that the operation is performed on. | ||||||||
required | object (ApplicationMarkers) The update to be applied to all IDs. | ||||||||
|
Responses
Request samples
- Payload
{- "filter": "name -eq Per",
- "scope": "All",
- "ids": [
- "19bb4eb7-3012-435a-9845-55626ef40460"
], - "body": {
- "singleSignOn": true,
- "approved": true
}
}
Response samples
- 202
- 400
- 500
{- "id": "483c67cf-e247-4a82-bef7-b86a29560788",
- "_links": {
- "0": {
- "href": "api/saas/consolidated-view/v1/tasks/483c67cf-e247-4a82-bef7-b86a29560788",
- "rel": "self",
- "method": "GET"
}
}
}
Get application users consumptions
Returns a collection of application users and their consumption details.
Authorizations:
path Parameters
applicationId required | string The unique ID of the application. |
query Parameters
page_number | integer <int32> Default: 1 The page number. |
page_size | integer <int32> Default: 100 The maximum number of items in the response. |
filter | string Example: filter=?filter=field1 -eq 'abc' For more information on the available operators and which data types those operators work on, see Filter API call results. |
sort | string Example: sort=?sort=field1:asc For more information on sorting capability and examples, see Sort API call results. |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "pagination": {
- "page_size": 100,
- "page_number": 1,
- "total_pages": 1,
- "total_items": 1
}, - "items": [
- {
- "id": "19bb4eb7-3012-435a-9845-55626ef40460",
- "createdDate": "2024-10-01",
- "discoveryTypes": [
- 1
], - "isOnline": true,
- "lastActiveValueType": 5,
- "userCostPerMonth": 1000,
- "displayName": "John Doe.",
- "isInReview": true,
- "lastActive": "2030-01-02T15:04:05",
- "lastActiveValueInInt": 1,
- "status": "Active",
- "roles": {
- "0": "GCS Support Engineer"
}, - "isMonitored": true,
- "department": "Sales",
- "email": "john.doe@organization.com",
- "isQualified": true,
- "potentialSavings": 500,
- "envelopeusage": 2
}
]
}
Get task
Returns the details of the given task.
Authorizations:
path Parameters
id required | string Example: 5b35aa33-e7a8-47a3-b1b6-19099ebb6bfd The unique ID of the task. |
Responses
Response samples
- 200
- 404
- 500
{- "id": "483c67cf-e247-4a82-bef7-b86a29560788",
- "name": "Bulk update applications",
- "status": "Complete",
- "description": "The export completed successfully.",
- "_links": {
- "0": {
- "href": "/api/saas/consolidated-view/v1/applications/bulk-update/483c67cf-e247-4a82-bef7-b86a29560788",
- "rel": "bulk-update-users",
- "method": "GET"
}
}
}