onprem
onprem
__public__

Activate an on-prem license and return a signed entitlement JWT

post/onprem/v1/activate

Request body

license_keystring required

Raw license key issued to the customer

deployment_idstring required

Stable uuid string self-generated by the install on first boot

versionstring nullable

On-prem build version, for bookkeeping

deployment_mode'self_hosted' | 'definite_hosted' nullable

self_hosted for customer infra, definite_hosted for Definite-operated infra; omitted means preserve existing mode or default first activation to self_hosted

cloud_providerstring nullable

Cloud provider for hosted deployments

broker_public_keystring nullable

Ed25519 public key (PEM) the deployment uses to sign OAuth-broker calls. Optional and backward-compatible; re-activation rotates it (contract §3).

upgrade_policystring nullable

Remote-upgrade consent policy the deployment runs under (manual|notify|auto). Observability only.

release_channelstring nullable

Release channel the deployment follows (e.g. stable/canary/pinned). Non-pinned channels are advertised the blessed release.

Response

Success

successtrue required

Flag for it request was successful

Changes