post/key/activate

Activate Key

Activate a node-locked license key on a specific user's hardware device. Client keys may optionally include licensee to claim an unassigned license during activation.

Authentication required: Bearer Token in Authorization header.

Parameters

Idempotency-Key

string (header)

Client-generated unique key making a mutating request idempotent. Replaying a request with the same key returns the original result instead of duplicating side effects. Optional on POST/PUT/PATCH/DELETE.

e.g. <IDEMPOTENCY-KEY>

Request Body (application/json)

productIdrequired

string

licenseKeyrequired

string

hostId

string

deviceTag

string

licensee

object

Optional first-time licensee claim for anonymous buyers. Only applies when the license is currently unassigned.

Responses

200License key activated successfully

Response Body (200)

code

integer

message

string

licenseeName

string

licenseeEmail

string

metadata

object (nullable)

Arbitrary key-value pairs (or null if none)

allowedHosts

array (nullable)

Authorized machine IDs for node‑locked licenses

versionId

string (nullable)

The ID of the product version associated with this license key

version

object (nullable)

Detailed information about the associated product version

Request Example

curl -X POST "https://api.keymint.dev/key/activate" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "productId": "string",
  "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX",
  "hostId": "string",
  "deviceTag": "string",
  "licensee": {
    "name": "string",
    "email": "user@example.com"
  }
}'

Response (200 OK)

{
  "code": 0,
  "message": "License valid",
  "licenseeName": "License Test Customer",
  "licenseeEmail": "license-1756752346942@example.com",
  "allowedHosts": [
    "MACHINE-A1B2C3"
  ]
}