License Manager error list

Reference every License Manager error code, title, and message so you can diagnose authorization failures and licensing issues on paid Lerian plugins quickly.

License validation errors occur when a paid plugin is used without proper authorization. The system checks the LICENSE_KEY and ORGANIZATION_IDS variables set in the environment (for example, in your .env file) to ensure that only organizations with an active contract can access licensed features.

This mechanism helps prevent unauthorized use of paid plugins, such as cases where there’s no active agreement in place.

Error format

JSON

{  
   "code": "<error_code>",  
   "title": "<error_title>",  
   "message": "<error_message>"  
}

Field definitions

• code – A stable, unique identifier for the error. Useful for programmatic handling and support requests.
• title – A short, human-readable summary of the issue.
• message – Detailed guidance to help you resolve the error.

This structure ensures you always get actionable feedback when something doesn’t go as expected.

License Manager errors

---

Refer to the table below for a list of possible error codes, their meanings, and instructions on how to resolve them.

code	title	message
LCS-0001	Internal server error	An internal server error occurred. Please try again later or contact support if the problem persists.
LCS-0002	No organization IDs configured	The application is not configured with any organization IDs.
LCS-0003	No valid licenses found for any organization	No valid licenses were found for any of the configured organizations. Please check your license keys and ensure at least one organization has a valid license.
LCS-0010	Organization ID header is missing	The X-Organization-ID header is missing. Please ensure the header is included in the request.
LCS-0011	Organization ID header is unknown	The organization ID ‘12345’ was not found in the list of configured organizations. Please verify you are using a valid organization ID.
LCS-0012	Failed to validate organization license	License validation failed for organization ID 12345. This could be due to network issues, invalid license keys, or server-side problems. Please verify your license key is correct and that you have network connectivity to the license server.
LCS-0013	Organization license is invalid	The license for organization ID ‘12345’ is not valid and has no grace period active. Please renew your license or contact support for assistance.
LCS-1001	Validation error	Could not validate license key. Please try again later or contact your system administrator.
LCS-1002	License not found	There is no license for this license key.
LCS-1003	License expired	The license key has expired.
LCS-1004	License suspended	The license key has been suspended due to payment issues or administrative action.
LCS-1005	Fingerprint mismatch	The license key or organization ID are not valid for this license.
LCS-1006	Product mismatch	There is no license for this product.