License API
Error Responses
1min
the following is a list of all error responses returned by the license api all errors have an http status of 400 of higher and the response body is a json object in the following format { status number, code string, message string } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "properties" { "status" { "type" "number" }, "code" { "type" "string" }, "message" { "type" "string" } }, "required" \[ "status", "code", "message" ], "additionalproperties" false } code status notes 404 not found requested api path doesn't exist 400 validation error caused by request data not conforming to the validation schema the message of the error response contains details on what failed 400 missing headers a required header is missing 400 missing parameters a required parameter in the query or body of the request is missing 400 missing content an offline activation/deactivation request received an empty request 400 invalid json caused by general invalid json in post requests 400 active license required a /versions or /installation file request is called without an active license provided in the parameters 400 api key product not allowed an activation is being attempted using an api key which does not have permissions to activate the requested product 400 archived product an activation is being attempted on a product which is archived 400 authorization invalid headers provided authorization header is malformed 400 authorization missing params provided authorization header has missing data 400 blacklisted activation is being attempted using a blacklisted device 400 borrow until not valid /floating/borrow is being called with an invalid borrowed until date 400 change password not allowed /change password is being called but is not allowed 400 customer account id mismatch 400 customer account not found when creating an order, the provided customer account id does not match an existing customer 400 customer does not exist /customer license users is being called but the provided customer does not exist 400 customer not found /customer license users is being called with authorization values which do not grant permissions to view data for the given customer 400 device not found a license deactivation or an endpoint which changes license values is being called using an inactive license device 400 disabled product a license activation is being attempted on a product which is disabled 400 email missing a request to generate a trial license for a user based license is being attempted with no email provided 400 feature not enough consumptions adding a feature consumption is being attempted but the consumption limit has already been reached 400 feature not floating /floating/feature release is being called on a feature which is not a floating cloud feature 400 floating feature device not in use /floating/feature release is being called on a feature which has no associated used device 400 floating not available a check, borrow or release is being called on a floating cloud license which has no available slots left 400 hardware key required an action is being attempted which requires a licensespring hardware key header 400 hmac required an api key based authorization header was sent but is missing a hmac value 400 invalid api key an invalid api key is being used 400 invalid hardware id an action requiring a hardware id parameter received an empty hardware id 400 invalid license feature code a license feature action is being attempted on a feature which cannot be found 400 invalid product auth method /customer license users is being called on a product which is not a user based product 400 invalid value a provided parameter does not contain a valid value the message of the error will contain more information on the parameter and acceptable values 400 key product based does not allow users an order is being created for a key based license, but a list of users was provided 400 license activated max times a new license activation is being attempted, but the license has already been activated the maximum number of times allowed 400 license borrow not allowed a license borrowing is being attempted on a license which does not allow borrowing 400 license device exists 400 license expired a license activation or borrowing is being attempted on an expired license 400 license hwid not found /device licenses is being called, but the provided device has no associated licenses 400 license not active an action is being attempted on a license which is not active 400 license not consumption a consumption action is being attempted on a license which is not a consumption type license 400 license not enabled an action is being attempted on a license which is not enabled 400 license not enough consumptions adding a license consumption is being attempted but the consumption limit has already been reached 400 license not found an action is being attempted on a license which cannot be found 400 license start date error a license activation is being attempted but is not allowed by the license's start date 400 license transferred max times a license transfer is being attempted, but the maximum number of allowed transfers has already been reached 400 license user activated max times a new license activation is being attempted, but the license user has already activated this license the maximum number of times allowed 400 license user not found an action is being attempted for a user based license, but the provided user is not associated to the license 400 license users error an order is being created but the number of provided users exceeds the max license users value set on the license 400 missing hardware key certificate a request requiring a licensespring hardware key was sent but the device specified has no assigned device certificate 400 negative consumptions not allowed a consumption request with a negative consumption value was sent, but negative consumptions are not allowed on this license 400 oauth product not allowed an oauth authorized request is being attempted using oauth credentials which do not have access to the requested resource 400 oauth required a request is being attempted using api key credentials, but oauth is enforced as the only allowed authorization mechanism 400 oauth token expired a request is being attempted using an expired oauth token 400 oauth token malformed a request is being attempted using a malformed oauth token 400 offline floating cloud not supported an offline activation is being attempted on a floating cloud license which does not allow offline activation 400 product not bundle a bundle action is being attempted but the specified product is not a bundle 400 quantity too large a request for generating license keys was sent to the /license webhook, but the requested amount of keys to generate exceeds the maximum allowed quantity 400 read only api key a non read action is being attempted using a read only api key 400 revoked api key an action is being attempted using an api key which has been revoked 400 trial expired an activation is being attempted on an expired trial license 400 trial not allowed a trial license is being requested but the product does not allow trial licenses 400 unknown policy code a license policy was specified in the request but no such policy was found 400 unknown product code a product code was specified in the request but no such product was found 400 unsupported product feature a feature consumption is being attempted on a feature which is not a consumption feature 400 user based product does not allow license key a license in the order request contains a license key but the product is not a key based product 400 user not assigned to product a /user licenses request has been sent but the provided user is not assigned to any license 400 version not found an /installation file request has been sent but no file version has been found that matches the given parameters 400 vm not allowed an activation is being attempted which was sent from a virtual machine but the licenses disallows vm activations 401 authentication failure authentication for the request has failed 401 hardware key signature mismatch the hardware key value sent in the licensespring hardware key is invalid 401 invalid client credentials oauth authentication failed 401 offline signature mismatch an offline activation or deactivation is being attempted but the provided signature value is invalid 401 signature mismatch an api key request is being sent but the signature in the header is invalid 409 license key exists an order request has been sent but failed due to a license key collision 409 order id exists a non appending order request has been sent but the provided order id already exists 500 internal error an unexpected server error has occured 500 adding manager error an error has occured while attempting to assign a license manager 500 mail sending error an error has occured while attempting to send a notification for a consumption or assigning a license user to a license order 500 notification sending error an error has occured while attempting to send a notification for a license activation, trial key, order creation