Examples

Activate

curl -X POST https://yourdomain.com/api/v1/license/activate \
  -H "Content-Type: application/json" \
  -d '{
        "license_key": "TIIP-XXXXX-XXXXX-XXXXX-XXXXX",
        "machine_fingerprint": "a1b2c3...",
        "hostname": "node1.example.com",
        "panel_version": "1.4.0",
        "os": "Ubuntu 22.04"
      }'

Response:

{
  "valid": true,
  "plan": "starter",
  "expires_at": "2027-01-01 00:00:00",
  "server_limit": 3,
  "activations_used": 1,
  "features": ["backups", "multi-php"],
  "signature": "base64-signature..."
}

A rejected activation returns a specific code instead of a generic failure, e.g.:

{ "valid": false, "code": "SLOT_LIMIT_REACHED", "message": "Server limit reached for this license." }

See Common Errors for what each code means and how to resolve it.