Suspending Licenses

Suspending a license will cause LexActivator IsLicenseGenuine() function to return LA_SUSPENDED status code on the user machine, based on which you can take any action in your application.

Allowing the license later will automatically cause LexActivator IsLicenseGenuine() function to return LA_OK status code. User doesn't need to reactivate the license.

Suspending a license is appropriate when you expect the license to become valid again without requiring user action. Typical scenarios include:

  • Temporary payment issues, such as a failed renewal or an invoice pending payment
  • Short-term policy or usage violations that can be resolved
  • Temporarily blocking access while an issue is being reviewed or investigated
  • Grace period handling for subscriptions

In these cases, the license data remains intact on the client machine. Once the license is allowed on the server side, the application automatically returns to a valid state without requiring a reactivation.

Suspending a license

To suspend a license you need to hit the license update endpoint and set suspended property to true.

PATCH https://api.cryptlex.com/v3/licenses/:id

Path Parameters

NameTypeDescription
idstringUnique identifier for the license

Headers

NameTypeDescription
AuthorizationstringBearer Access Token

Request Body

NameTypeDescription
suspendedbooleanSet true to suspend the license

{
  "key": "0A2035-E8A2A3-4D31B7-8FF9C6-81A6CA-539E54",
  "revoked": false,
  "suspended": true,
  "totalActivations": 0,
  "totalDeactivations": 0,
  "validity": 2595000,
  "expirationStrategy": "immediate",
  "fingerprintMatchingStrategy": "fuzzy",
  "allowedActivations": 1,
  "allowedDeactivations": 10,
  "type": "node-locked",
  "allowedFloatingClients": 0,
  "serverSyncGracePeriod": 2595000,
  "serverSyncInterval": 3600,
  "leaseDuration": 0,
  "expiresAt": "2018-07-06T08:49:17.9361143Z",
  "allowVmActivation": true,
  "userLocked": false,
  "productId": "63dfd63e-ed71-4f84-9236-02ee0ddb062c",
  "user": null,
  "allowedCountries": [],
  "disallowedCountries": [],
  "allowedIpAddresses": [],
  "disallowedIpAddresses": [],
  "metadata": [],
  "tags": [],
  "id": "23d9646c-34f5-4d37-adeb-f7f77b927bdb",
  "createdAt": "2018-05-06T08:49:17.9361143Z",
  "updatedAt": "2018-05-06T08:49:17.9361158Z"
}
Meter AttributesRevoking Licenses
Last updated: