API Reference — Activate

POST /api/v1/licenses/activate

Activates a license key for a specific device. Returns a signed JWT token for subsequent API calls.

Request Body

{
  "license_key": "XXXX-XXXX-XXXX-XXXX",
  "device_id": "unique-device-fingerprint",
  "device_name": "MacBook Pro"
}

Parameter	Type	Required	Description
`license_key`	string	Yes	The license key from your purchase
`device_id`	string	Yes	Unique device fingerprint
`device_name`	string	Yes	Human-readable device name

{
  "token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_at": "2026-04-18T00:00:00Z",
  "device": {
    "id": 1,
    "name": "MacBook Pro"
  }
}

Status	Description
`422`	Invalid license key or missing parameters
`403`	Device limit reached for this license
`404`	License key not found