Skip to main content

Applications

SaaS: Applications (1.2.0)

Download OpenAPI specification:Download

API for interacting with SaaS applications.

Applications

Get applications

Returns the details of a list of applications.

Authorizations:
bearerAuth
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

Content type
application/json
{
  • "items": [
    ],
  • "pagination": {
    }
}

Get application

Returns the details of an application.

Authorizations:
bearerAuth
path Parameters
applicationId
required
string

The unique ID of the application.

Responses

Response samples

Content type
application/json
{
  • "id": "19bb4eb7-3012-435a-9845-55626ef40460",
  • "name": "Teams",
  • "vendor": "Microsoft Corp.",
  • "vendorId": "365540e0-3150-48b9-9841-dbff43925065",
  • "licenses": [
    ],
  • "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": [
    ],
  • "discoveryDate": "2024-10-01",
  • "discoverySource": "Manual.",
  • "categoryName": "Digital Content Editing Platform",
  • "website": "http://www.adobe.com/",
  • "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:
bearerAuth
path Parameters
applicationId
required
string

The unique ID of the application.

Request Body schema: application/merge-patch+json
required

An application to be updated.

primaryOwnerId
string

The unique ID of the primary owner.

sanctioned
boolean

true if application is sanctioned; otherwise, false.

singleSignOn
boolean

true if application has single sign on supported; otherwise, false.

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)
website
string

Website of application.

privacyPolicy
string

Location of the applications privacy policy.

categoryName
string

Category of application.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "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": {}
}

Response samples

Content type
application/json
{
  • "id": "19bb4eb7-3012-435a-9845-55626ef40460",
  • "name": "Teams",
  • "vendor": "Microsoft Corp.",
  • "vendorId": "365540e0-3150-48b9-9841-dbff43925065",
  • "licenses": [
    ],
  • "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": [
    ],
  • "discoveryDate": "2024-10-01",
  • "discoverySource": "Manual.",
  • "categoryName": "Digital Content Editing Platform",
  • "website": "http://www.adobe.com/",
  • "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:
bearerAuth
path Parameters
applicationId
required
string

The unique ID of the application.

Responses

Response samples

Content type
application/json
{
  • "id": "e5ea6f20-47ad-41be-a3c5-839409d89791",
  • "monthlyCost": {
    },
  • "subscriptionTypes": {
    },
  • "subscriptions": {
    },
  • "totalUsers": {
    },
  • "unassignedSubscriptions": {
    }
}

Get applications overview KPIs

Returns the details of the applications overview key performance indicators.

Authorizations:
bearerAuth
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

Content type
application/json
{
  • "applicationDiscoveryLastSevenDays": [
    ],
  • "notApproved": { },
  • "total": [
    ]
}

Get applications KPIs

Returns the details of the KPIs for all applications.

Authorizations:
bearerAuth
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

Content type
application/json
{
  • "totalApplications": 15,
  • "totalApplicationsTrend": 7,
  • "unsanctioned": 2,
  • "appCategories": [
    ],
  • "aiAppCategories": [
    ],
  • "appCategoriesUnsanctioned": [
    ],
  • "aiAppCategoriesUnsanctioned": [
    ],
  • "activeUserApplications": [
    ],
  • "activeUserApplicationsUnsanctioned": [
    ]
}

Get application users

Returns a collection of users assigned to an application.

Authorizations:
bearerAuth
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

Content type
application/json
{
  • "pagination": {
    },
  • "items": [
    ]
}

Bulk update applications

Modifies a collection of application properties the provided applications.

Authorizations:
bearerAuth
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.

singleSignOn
required
boolean

true if the application is marked as single sign-on only; otherwise, false.

approved
required
boolean

true if the application is marked as for approved; otherwise, false.

Responses

Request samples

Content type
application/json
{
  • "filter": "name -eq Per",
  • "scope": "All",
  • "ids": [
    ],
  • "body": {
    }
}

Response samples

Content type
application/json
{
  • "id": "483c67cf-e247-4a82-bef7-b86a29560788",
  • "_links": {
    }
}

Tasks

Get task

Returns the details of the given task.

Authorizations:
bearerAuth
path Parameters
id
required
string

The unique ID of the task.

Responses

Response samples

Content type
application/json
{
  • "id": "483c67cf-e247-4a82-bef7-b86a29560788",
  • "name": "Bulk update applications",
  • "status": "Complete",
  • "description": "The export completed successfully.",
  • "_links": {
    }
}