Deprecations

This page is a dated log of everything that has been deprecated across the Cryptlex Web API and SDKs, newest first. Each section covers one deprecation, what replaces it, and how to migrate. Deprecated items continue to work for backward compatibility, but you should update your integration to the replacements.

Validity and expiration strategy on maintenance policies

Deprecated in November 2025 (Web API 3.81.0)

The validity and expirationStrategy properties on maintenance policies are replaced by subscriptionInterval and subscriptionStartTrigger, the same model licenses moved to.

To migrate:

  1. Update each maintenance policy, in the admin portal or through the Web API, to use a subscription interval and start trigger instead of validity and expiration strategy.
  2. If your scripts create or update maintenance policies through the Web API, send subscriptionInterval and subscriptionStartTrigger instead of validity and expirationStrategy.

Existing maintenance policies keep working, and no SDK changes are required.

Trial activation extend endpoint

Deprecated in September 2025 (Web API 3.80.0)

The POST /v3/trial-activations/:id/extend endpoint is replaced by PATCH /v3/trial-activations/:id/expires-at.

To migrate, replace calls to the extend endpoint with the expires-at endpoint, and send the exact new expiration date instead of a duration to add.

Product versions and feature flags

Deprecated in May 2025 (Web API 3.78.0, LexActivator 3.32.0, LexFloatClient 4.11.0)

Product versions and feature flags are replaced by features and Entitlement Sets:

  • Product versions (/v3/product-versions) are replaced by Entitlement Sets (/v3/entitlement-sets), which group features into named tiers.
  • Feature flags (/v3/feature-flags) are replaced by features (/v3/features) and feature entitlements, which support per-license overrides that feature flags did not.

To migrate:

  1. Recreate your product versions as Entitlement Sets and your feature flags as features, then link an Entitlement Set to each license template and license. See Features and Entitlement Sets.
  2. Update Web API scripts that call /v3/product-versions or /v3/feature-flags to use /v3/entitlement-sets and /v3/features.
  3. Replace the deprecated SDK functions with their replacements:
SDKDeprecatedReplacement
LexActivatorGetProductVersionName()GetLicenseEntitlementSetName()
LexActivatorGetProductVersionDisplayName()GetLicenseEntitlementSetDisplayName()
LexActivatorGetProductVersionFeatureFlag()GetFeatureEntitlement()
LexFloatClientGetHostProductVersionName()GetHostLicenseEntitlementSetName()
LexFloatClientGetHostProductVersionDisplayName()GetHostLicenseEntitlementSetDisplayName()
LexFloatClientGetHostProductVersionFeatureFlag()GetHostFeatureEntitlement()

See Accessing feature entitlements for how the replacement functions work.

Validity and expiration strategy on licenses

Deprecated in May 2025 (Web API 3.78.0)

The validity and expirationStrategy properties on licenses and license templates are replaced by subscriptionInterval and subscriptionStartTrigger. See Subscription Licensing for how the new model works.

The migration requires no changes in LexActivator, LexFloatClient, or LexFloatServer; all functionality continues to work as before. Backward compatibility is fully maintained, so existing licenses using validity keep working.

To use the new model for future licenses, update each license template:

  1. Clear the Validity and Expiration Strategy fields.
  2. Set the Subscription Interval (for example, 1 month instead of 30 days) and the Subscription Start Trigger:
    • Use License Creation if the old expiration strategy was Immediate.
    • Use License Activation if it was Delayed.

Modifying a license template does not affect existing licenses. You can either keep them on validity (the renewal and extension APIs remain supported) or migrate each license using the Update Subscription Parameters action from the Actions menu in the license table, setting the Subscription Interval and the appropriate Start Trigger.

The duration-based extend endpoints are also deprecated. Replace them with the expires-at endpoints, which take an exact expiration date instead of a duration:

DeprecatedReplacement
POST /v3/licenses/:id/extendPATCH /v3/licenses/:id/expires-at
POST /v3/licenses/:id/maintenance/extendPATCH /v3/licenses/:id/maintenance/expires-at

The disableClockValidation property

Deprecated in June 2024 (Web API 3.72.0)

The disableClockValidation property on licenses is replaced by allowedClockOffset.

To migrate, set allowedClockOffset to -1 instead of setting disableClockValidation to true when creating or updating licenses and license templates.

The CheckForReleaseUpdate function

Deprecated in April 2023 (LexActivator 3.21.0)

The CheckForReleaseUpdate() function is replaced by CheckReleaseUpdate(), whose callback also reports whether the update is allowed for the license.

To migrate, replace the function call and update your callback to handle the release object and the update-allowed status. See Auto-Updates for a complete example.

Filter query parameters

Deprecated in September 2021 (Web API 3.44.0)

The fixed filter query parameters listed below are replaced by query operators.

DeprecatedReplacementEndpoints
createdAfter, createdBeforecreatedAt[gt], createdAt[lt]/v3/licenses, /v3/users, /v3/activation-logs
lastSeenAfter, lastSeenBeforelastSeenAt[gt], lastSeenAt[lt]/v3/users
metadataKey, metadataValuemetadata.key, metadata.value/v3/licenses, /v3/users
emailuser.email/v3/licenses

To migrate, replace each deprecated parameter with its operator form. For example, createdAfter=2021-01-01 becomes createdAt[gt]=2021-01-01.

The roles property on users

Deprecated in December 2018 (Web API 3.9.0)

The roles array on users is replaced by a single role property.

To migrate, update scripts that read or set roles on the /v3/users endpoints to use role.

Where deprecations are announced

When something is deprecated, it is noted in the corresponding changelog (Web API, LexActivator, LexFloatClient, LexFloatServer) and added to this page.

SAML SSOWeb API
Last updated: