Skip to content

Licence API

POST /licence/v1/activate

Registers an installation against a licence seat. Idempotent per site: re-activating the same installation never consumes an extra seat.

Request

POST https://parmtech.au/licence/v1/activate
Content-Type: application/json

{
  "licence_key": "PT-SSLGODPR-…-A9F2",
  "domain": "example.com",
  "install_id": "optional stable id for this install",
  "environment": "production",
  "version": "2.5.0",
  "php": "8.3.8"
}

Responses

201 Created

{ "activated": true, "activation_id": "…", "domain": "example.com" }

422 — seat limit reached, unknown key, or invalid key format. The error.message is safe to show to the user.

Rate limit: 60 requests/minute per key + IP.