Applications
SaaS: Applications (1.2.0)
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 <int64> Default: 1 The page number. |
page_size | integer <= 1000 Default: 100 The maximum number of items in the response. |
filter | string Example: filter=(displayName -eq Teams) -and (status -in [Active, Inactive]) For more information on the available operators and which data types those operators work on, see Filter API call results. |
sort | string Example: sort=displayName:asc,status:dsc 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"
}
], - "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"
}
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 | string The unique ID of the primary owner. | ||||||
sanctioned | boolean
| ||||||
singleSignOn | boolean
| ||||||
notes | string Notes about the application. | ||||||
description | string Description of the application. | ||||||
aiCategory | string AI category of the application. | ||||||
aiSubcategory | string AI sub-category of the application. | ||||||
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"
}
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 Example: a7a75b83-2690-4cc9-b652-a0fbe93dba4a The unique ID of the application. |
query Parameters
page_size | integer <= 1000 Default: 100 The maximum number of items in the response. |
page_number | integer <int64> Default: 1 The page number. |
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
}
]
}
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 Enum: "Only" "All" "AllExcept" 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 task
Returns the details of the given task.
Authorizations:
path Parameters
id required | string 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"
}
}
}