v1

latestOpenAPI 3.0.42026-08-062942352.0 MB

Licenses

Create a license

Creates a new license.

post/v3/licenses

Request body

keystring nullable

The key associated with the license. If left empty, key is auto-generated.

revokedboolean nullable

Set true to revoke the license.

suspendedboolean nullable

Set true to suspend the license.

fingerprintMatchingStrategy'fuzzy' | 'exact' | 'loose' nullable

Strategy for matching machine fingerprint.

allowedActivationsinteger nullable

Allowed number of activations for the license. Set to 0 or -1 for unlimited activations.

allowedDeactivationsinteger nullable

Allowed number of deactivations for the license. Set to -1 for unlimited deactivations. This setting is ignored for floating licenses.

leaseDurationinteger nullable

Duration of lease for floating licenses. Set to 0 or -1 for unlimited lease duration.

allowClientLeaseDurationboolean nullable

Allow client to set the lease duration for floating licenses.

allowedFloatingClientsinteger nullable

Allowed number of floating clients for the On-Premise LexFloatServer.

serverSyncGracePeriodinteger nullable

The duration for which the server sync failure due to network error is acceptable. Set to -1 for an unlimited grace period.

serverSyncIntervalinteger nullable

The interval at which license data in client is synced with the server.

allowedClockOffsetinteger nullable

The allowed clock offset between the network time and the local time. Set to -1 to disable clock validation checks.

disableClockValidationboolean nullable

Disables clock validation checks on the licensed machine for perpetual licenses.

cryptoBindingEnabledboolean nullable

Whether crypto binding is enabled for the license.

expiringSoonEventOffsetinteger nullable

Specifies the offset in seconds before the license's expiration date or the license's maintenance expiration date at which the 'license.expiring-soon' or 'license.maintenance-expiring-soon' webhook event is triggered. This early warning ensures that clients are alerted in advance to take necessary actions before the license or license maintenance expires.

allowVmActivationboolean nullable

Indicates whether activation is permitted within a virtual machine environment. Setting this to true allows the license to be activated in virtual machines, which may be necessary for certain deployment scenarios.

allowContainerActivationboolean nullable

Indicates whether activation is permitted within a container environment. Setting this to true allows the license to be activated in containers, which is essential for modern cloud-native applications.

disableGeoLocationboolean nullable

Whether IP address and geo-location should be stored.

notesstring nullable

Notes to store with the license.

allowedIpRangesstring[] nullable

Allowed IP ranges. Leave empty to ignore.

allowedCountriesstring[] nullable

List of the allowed countries. Leave empty to ignore.

disallowedCountriesstring[] nullable

List of the disallowed countries. Leave empty to ignore.

allowedIpAddressesstring[] nullable

List of the allowed ip addresses. Leave empty to ignore.

disallowedIpAddressesstring[] nullable

List of the disallowed ip addresses. Leave empty to ignore.

userIdstring nullable

Unique identifier for the user.

resellerIdstring nullable

Unique identifier for the reseller user.

organizationIdstring nullable

Unique identifier for the organization.

additionalUserIdsstring[] nullable

Unique identifier for the additional users.

productVersionIdstring nullable

Unique identifier for the product version.

entitlementSetIdstring nullable

Unique identifier for the Entitlement Set.

maintenancePolicyIdstring nullable

Unique identifier for the maintenance policy.

maxAllowedReleaseVersionstring nullable

The max allowed release version. This property is ignored if maintenance policy is set for the license. Only following three formats are allowed x.x, x.x.x, x.x.x.x.

tagsstring[] nullable

List of tags.

validityinteger nullable

The duration (in seconds) after which the license will expire. Set to '0' for no expiry.

expirationStrategy'immediate' | 'delayed' | 'rolling' nullable

The strategy to determine the expiration start date.

subscriptionIntervalstring nullable

The length of time which determines the subscription renewal cadence. ISO8601 durations accepted. Examples:

P1Y (1 year)
P6M (6 months)
P1M (1 month)
P1W (1 week)
P7D (7 days)
PT24H (24 hours)
PT1H (1 hour)
PT30M (30 minutes)

subscriptionStartTrigger'creation' | 'activation'

expiresAtstring date-time nullable

Set the EndDate of the License Subscription.

leasingStrategy'per-machine' | 'per-instance' nullable

Leasing strategy for hosted-floating and on-premise license.

userLockedboolean nullable

Locks the activation to the machine user.

type'node-locked' | 'hosted-floating' | 'on-premise-floating' nullable

Type of the license.

createdAtstring date-time nullable

This property should only be used if importing old licenses.

effectiveDatestring date-time nullable

Specifies the date after which the license becomes valid. Defaults to the current date if not set. Use this property to post-date or pre-date a license's usage.

productIdstring required

Unique identifier for the product.

licenseTemplateIdstring nullable

Unique identifier for the license template. Use this to override the default license template.

licensePolicyIdstring nullable

Use 'licenseTemplateId' instead.

Response

Created

idstring required

createdAtstring date-time required

updatedAtstring date-time required

keystring required

revokedboolean required

suspendedboolean required

perpetualboolean required

totalActivationsinteger required

totalDeactivationsinteger required

validityinteger nullable

expirationStrategy'immediate' | 'delayed' | 'rolling' nullable

subscriptionIntervalstring nullable

subscriptionStartTrigger'creation' | 'activation'

fingerprintMatchingStrategy'fuzzy' | 'exact' | 'loose' required

allowedActivationsinteger required

allowedDeactivationsinteger required

type'node-locked' | 'hosted-floating' | 'on-premise-floating' required

allowedFloatingClientsinteger required

serverSyncGracePeriodinteger required

serverSyncIntervalinteger required

allowedClockOffsetinteger required

cryptoBindingEnabledboolean required

disableClockValidationboolean required

expiringSoonEventOffsetinteger required

leaseDurationinteger required

leasingStrategy'per-machine' | 'per-instance' required

effectiveDatestring date-time nullable

expiresAtstring date-time nullable

activatedAtstring date-time nullable

lastUsedAtstring date-time nullable

allowVmActivationboolean required

allowContainerActivationboolean required

allowClientLeaseDurationboolean required

userLockedboolean required

requireAuthenticationboolean required

disableGeoLocationboolean required

notesstring nullable

productIdstring required

entitlementSetIdstring nullable

productVersionIdstring nullable

maintenancePolicyIdstring nullable

maintenanceExpiresAtstring date-time nullable

currentReleaseVersionstring nullable

maxAllowedReleaseVersionstring nullable

organizationIdstring nullable

userIdstring nullable

resellerIdstring nullable

additionalUserIdsstring[] required

allowedIpRangestring nullable

allowedIpRangesstring[] required

allowedIpAddressesstring[] required

disallowedIpAddressesstring[] required

allowedCountriesstring[] required

disallowedCountriesstring[] required

tagsstring[] required