Presence
Once a day every site running the suite — Community or Enterprise, with or without a key — tells the portal it exists. This is how we count the hosts and containers running the product.
POST /wp-json/pfw-portal/v1/presence
Public, no authentication (a presence report grants nothing), rate-limited to 30 per minute per IP. Form-encoded body:
| Field | Description |
|---|---|
site_fingerprint | The site's opaque identity (64 hex chars) |
site_host | The host name of the site's home URL |
runtime | wordpress, or docker inside our published image |
edition | community or enterprise |
license | The Enterprise key, when the site runs that edition; empty otherwise |
plugins | JSON object {slug: version} of the suite plugins installed |
wp_version, php_version | Compatibility tracking |
Response (200): {"status":"ok","next_report_after":86400}.
The portal keeps one row per fingerprint (first seen, last seen, the fields above) and links an Enterprise report to its licence. A host that stops reporting simply ages out of the "active" count; nothing is ever requested back from the site. No content of any kind — records, workflows, conversations, keys — travels in this call.