Skip to Content
CadNic Docs
CTRL K
API ReferenceLicensesActivate

Activate License

Activate a CadNic license on a device.

Endpoint

POST /api/v1/licenses/activate

Request Body

FieldTypeRequiredDescription
license_keystringYesThe license key to activate
device_idstringYesUnique identifier for the device
device_namestringNoHuman-readable device name
osstringNoOperating system (windows, macos, linux)
client_versionstringNoDesktop app version

Example Request

{
  "license_key": "SS-XXXX-XXXX-XXXX-XXXX",
  "device_id": "abc123-def456-ghi789",
  "device_name": "My Workstation",
  "os": "windows",
  "client_version": "1.0.0"
}

Response

Success (200)

{
  "success": true,
  "data": {
    "license_key": "SS-XXXX-XXXX-XXXX-XXXX",
    "device_id": "abc123-def456-ghi789",
    "activated_at": "2026-04-03T12:00:00Z",
    "activations_remaining": 2
  }
}

Error Responses

License Not Found (401)

{
  "error": "LICENSE",
  "message": "Invalid license key"
}

Activation Limit Reached (403)

{
  "error": "LICENSE",
  "message": "Activation limit reached. Deactivate a device first or upgrade your plan."
}

Rate Limited (429)

{
  "error": "RATE_LIMIT",
  "message": "Too many requests. Try again in 60 seconds."
}

Notes

  • Activation is idempotent: activating the same device twice returns success without creating a duplicate record
  • device_id should be a stable, unique identifier (hardware ID, machine GUID, etc.)
  • device_name is for display purposes only
  • Maximum 10 requests per minute per IP address
OverviewValidate