Skip to main content

Other REST endpoints

warning

The endpoints on this page are integration and webhook surfaces, not part of the general Manage API. They do not follow the dispatch/manifest pattern and most require signed or tokenized requests specific to each subsystem. Do not attempt to call them with a som_ API key unless explicitly noted.

Licensing

Namespace: syteops/v1. Authentication: HMAC-signed requests.

MethodPathAuthPurpose
POST/license/webhookHMACReceives license lifecycle events from the upstream licensing service
POST/license/validateHMACValidates a license key and records the result locally
POST/license/controlHMACApplies a control instruction (e.g. suspend or reinstate) to the local install
POST/license/syte-gateway-purchaseHMACRecords a purchase event arriving from the Syte gateway
POST/license/syte-gatewayHMACGeneral Syte gateway webhook receiver

Leads ingest

Namespace: syteops/v1. Authentication: rotating short-lived token.

MethodPathAuthPurpose
GET/leads/bootstraptokenMints a short-lived, rate-limited, cache-safe ingest token for a visitor session
POST/leads/ingesttokenRecords a conversion event; requires the rotating token returned by bootstrap

The bootstrap/ingest pair is designed for front-end use: the page fetches /leads/bootstrap to obtain a token, then uses that token to call /leads/ingest. The token is rate-limited and cache-safe so that CDN or page-cache hits on the bootstrap request do not reuse stale tokens.

Leads qualification

Namespace: syteops/v1. Authentication: ingest token (same gate as /leads/ingest).

MethodPathAuthPurpose
POST/leads/qualifytokenRuns qualification logic against a lead record; reuses the ingest token gate

Leads proof

Namespace: syteops/v1. Authentication: HMAC query token.

MethodPathAuthPurpose
GET/leads/proof/{ref}HMAC t paramReturns a read-only HTML proof packet for the lead identified by ref; the t query parameter carries the HMAC token

The ref path segment identifies a specific lead record. The t query parameter must carry a valid HMAC-signed token; requests without a valid token are rejected. The response is an HTML document, not JSON.

LinkCentral

Namespace: syteops/v1. Authentication: bearer token. These endpoints are only registered when the LinkCentral integration is enabled.

MethodPathAuthPurpose
POST/linkcentral/process-linksbearerProcesses and persists link data submitted by LinkCentral
POST/linkcentral/preview-linksbearerReturns a preview of how submitted links would be resolved without persisting
GET/linkcentral/statusbearerReturns the current status of the LinkCentral integration

ContentPen relay

Namespace: syteops-int-cp/v1. Authentication: HMAC signature verification.

MethodPathAuthPurpose
POST/webhookHMACVerifies the request signature and relays the payload to the configured automation or FlowMattic workflow

The ContentPen relay lives under its own namespace (syteops-int-cp/v1) and is only active when the ContentPen integration module is enabled. The receiving handler verifies the HMAC signature before forwarding; payloads that fail signature verification are silently dropped.