post/key/deactivate

Deactivate Key

Deactivate a license to free up a machine activation seat. Client keys must include hostId and can only deactivate that device.

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

Required when using a client-scoped API key. Admin keys may omit hostId to remove all activations for the license.

Responses

200License key deactivated successfully

Response Body (200)

message

string

code

integer

Request Example

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

Response (200 OK)

{
  "message": "Device deactivated",
  "code": 0
}