NIninjarmm
Software Licenses

Create or Update a Software License

Changed on

Create or Update a Software License in a simple way

post/v2/software-license/upsert

Request

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'
currency'USD' | 'EUR' | 'CAD' | 'GBP' | 'AUD' | 'JPY' | 'SEK' | 'NOK' | 'DKK' | 'CHF' | 'AED' | 'AFN' | 'ALL' | 'AMD' | 'AOA' | 'ARS' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CDF' | 'CHE' | 'CHW' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'FJD' | 'FKP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'UYI' | 'UYU' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAD' | 'XAF' | 'XCD' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWG'
firstFoundAtinteger
lastUsageAtinteger

Changes

  • 5932b93aea2aRevision changes
    • info

      added the optional property to the response with the status

  • 753f26d46650Revision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status