License

Activate a license

Activates a license on a specific machine. If the machine is already activated, the activation record is updated with the latest app and OS version.

post/v1/license/activate

Request body

license_keystring required

License key in format XXXXX-XXXXX-XXXXX-XXXXX-XXXXX.

machine_idstring required

SHA-256 hash of machine identifier (64 hex characters).

machine_namestring required

Human-readable machine name.

app_versionstring required

Application version.

os_versionstring required

Operating system version.

Example request

{
  "license_key": "ABCDE-12345-FGHIJ-67890-KLMNO",
  "machine_id": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "machine_name": "John's MacBook Pro",
  "app_version": "0.2.0",
  "os_version": "macOS 15.3"
}

Response

License activated successfully. Returns signed license data.

signaturestring required

Cryptographic signature of the license data for client-side verification.

Example response

{
  "data": {
    "email": "john@example.com",
    "expires_at": "2027-02-11T00:00:00+00:00",
    "issued_at": "2026-02-12T10:30:00+00:00",
    "license_key": "ABCDE-12345-FGHIJ-67890-KLMNO",
    "status": "active"
  },
  "signature": "base64-encoded-signature"
}

Changes