Sign in

v2

latestOpenAPI 3.0.12026-07-263104131.9 MB
Software Licenses

Create or Update a Software License

Create or Update a Software License in a simple way

post/v2/software-license/upsert

Request body

namestring required

Indicates the name of the software license

descriptionstring nullable

Indicates a description for the software license

type'PER_DEVICE' | 'PER_USER' | 'CUSTOM' required

Indicates the type of the software license

dateinteger nullable

Indicates the purchase date of the software license in unix epoch milliseconds

publisherNamestring required

Name of the publisher

vendorNamestring required

Name of the vendor

quantityinteger required

Indicates the quantity of the software license

currentUsageinteger nullable

Indicates the current usage of the software license

currentLicenseesstring[]

Indicates the names of assigned licensees and removes those not specified

licenseesToAssignstring[]

Indicates the names of the licensees on which the license will be assigned

licenseesToRemovestring[]

Indicates the names of the licensees on which the license will be remowed

notestring nullable

Indicates a note about the software license

costMode'TOTAL' | 'PER_LICENSE' nullable

Indicates the cost mode of the software license

costnumber nullable

Indicates the cost of the software license

Example request

{
  "type": "PER_DEVICE",
  "date": 1672531199000,
  "usageMonitoring": {
    "binaries": [
      {
        "osType": "WINDOWS",
        "binaryNames": [
          "chrome.exe",
          "firefox.exe"
        ]
      }
    ]
  }
}

Response

The Software License that was created/updated

idinteger
namestring
descriptionstring
type'PER_DEVICE' | 'PER_USER' | 'CUSTOM'
automatedboolean
purchaseDateinteger
publisherIdinteger
vendorIdinteger
quantityinteger
currentUsageinteger
expiredboolean
daysToExpireinteger
notestring
perLicenseCostnumber
totalCostnumber
costMode'TOTAL' | 'PER_LICENSE'
firstFoundAtinteger
lastUsageAtinteger