Sign in

v1

latestOpenAPI 3.1.02026-07-2489171167.4 KB
License Manager Public

Update Application Details

Update the details of an existing application. Only the fields included in the request body will be updated.

patch/license-manager/applications/{id}

Path parameters

idstring required

The unique identifier of the application in SysAid (CUID format, 24 characters).

Request body

namestring
categorystring nullable

The application's business category. Allowed values: operations, sales-and-marketing, developer-tools, design, project-management, customer-success, human-resources, it-and-security, finance, productivity, analytics-and-bi, other.

statestring

The current state of the application in the review workflow. Allowed values: pending-review, under-review, optimization-opportunity, requested, approved, denied, ignored. Default is pending-review.

activeUsersinteger nullable

The number of users who logged in to the application in the last 30 days (active users). This value cannot be updated for applications that were discovered, only for applications that were manually added.

totalLicensesinteger nullable
totalCostnumber double nullable
currencystring

ISO 4217 currency code for cost fields. Allowed values: USD, EUR, GBP, CAD, CHF, SEK, NOK, DKK, MXN, PLN, BRL, ILS, AUD, NZD, ZAR, GHS, TTD.

Example request

{
  "category": "developer-tools",
  "activeUsers": 150,
  "currency": "USD"
}

Response

Application is successfully updated.

idstring required

The unique identifier of the application in SysAid (CUID format, 24 characters).

namestring required

The application name (1-255 characters).

descriptionstring nullable

A detailed description of the application.

discoveryMethodsDiscoveryMethod[]

The way in which the application was discovered. See DiscoveryMethod.

categorystring nullable

The application's business category. Allowed values: operations, sales-and-marketing, developer-tools, design, project-management, customer-success, human-resources, it-and-security, finance, productivity, analytics-and-bi, other.

statestring required

The current state of the application in the review workflow. Allowed values: pending-review, under-review, optimization-opportunity, requested, approved, denied, ignored. Default is pending-review.

vendorstring nullable

SaaS vendor or publisher name.

websitestring uri nullable

Official website URL for the application.

iconstring uri nullable

Full CDN URL to application/vendor logo.

totalLicensesinteger nullable

Number of purchased licenses.

activeUsersinteger nullable

Unique users who logged in over the last 30 days.

inactiveUsersinteger nullable

The number of inactive users - users that haven't signed in to the application in the last 30 days. Calculated as totalLicenses - activeUsers.

utilizationRateinteger nullable

The application's utilization rate. Calculated as (activeUsers / totalLicenses) * 100.

totalCostnumber double nullable

Total annual cost (precision 12,2).

costPerLicensenumber double nullable

The annual cost per license. Calculated as totalCost / totalLicenses (precision 12,2).

estimatedSavingsnumber double nullable

The potential sum you can save for this application. Calculated as inactiveUsers * costPerLicense (precision 12,2).

currencystring

ISO 4217 currency code for cost fields. Allowed values: USD, EUR, GBP, CAD, CHF, SEK, NOK, DKK, MXN, PLN, BRL, ILS, AUD, NZD, ZAR, GHS, TTD.

dateCreatedstring date-time required

The timestamp of when the application was created in the License Manager system.

dateUpdatedstring date-time nullable

The timestamp of when the application was last updated in License Manager. This includes changes to any application details or data.

Example response

{
  "category": "developer-tools",
  "currency": "USD",
  "dateCreated": "2025-06-15T10:30:00Z",
  "dateUpdated": "2025-08-20T14:30:00Z"
}