Sign up

Delete License

Deletes a license by its serial number. All activations belonging to that license are deleted along with it, so any device currently using the license stops validating.

DELETE https://api.keyzy.io/v2/licenses/destroy-serial

Requires a write API key. Never embed a write key in a distributable application — anyone who extracts it could delete your licenses. Call this endpoint from your backend, store, or automation tooling only.

If you only want to free up a seat, delete the activation instead and leave the license in place.

Parameters

ParameterTypeDescription
app_idstringAn app_id that has write permission
api_keystringAn api_key that has write permission
serialstringThe serial number of the license to delete
typestringThe type of the license: perpetual, subscription or trial

The type you send must match the actual type of the license. This is a safety check: if they do not match, nothing is deleted and the request fails. It protects you from deleting the wrong record when a serial number is passed in from an external system such as a store or a CRM.

Returns

Keyzy responds with a message confirming the deletion if the request is correct.

{
  "message": "License successfully deleted."
}

Errors

You are not authorized — the app_id / api_key pair is wrong, or the key does not have write permission.

{
  "error": {
    "message": "You are not authorized!",
    "status_code": 401
  }
}

License does not exist — no license with that serial number belongs to your account.

{
  "error": {
    "message": "License does not exist!",
    "status_code": 404
  }
}

License type mismatch — the license exists, but its type is not the type you sent. Nothing is deleted.

{
  "error": {
    "message": "License type mismatch!",
    "status_code": 422
  }
}

Notes