post/key/sign

Sign Offline Key

Generate an offline signed license key for a specific hardware device. This securely provisions an offline license while consuming a device activation slot.

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

The unique identifier of the product.

licenseKeyrequired

string

The license key string.

hostIdrequired

string

The unique hardware fingerprint of the device to be licensed.

ttl

integer

Optional time-to-live in seconds. Required when the license has no expiration date.

Responses

200Offline license key signed successfully

400Bad Request

403Forbidden - e.g. limit reached or unauthorized device

Response Body (200)

file

string

The JSON string representation of the signed license file.

Request Example

curl -X POST "https://api.keymint.dev/key/sign" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "productId": "string",
  "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX",
  "hostId": "string",
  "ttl": 1
}'

Response (200 OK)

{
  "file": "string"
}