Sites

Create a site

Domains are canonicalized and globally unique.

post/api/sites

Request

  • Base URL: https://slimlytics.com
  • URL: https://slimlytics.com/api/sites
  • Auth: HTTP bearer

Request body

namestring required
domainstring required
timezonestring
allowedOriginsstring[]
retentionDaysinteger

Example request

{
  "domain": "example.com"
}

Response

Site created

idstring uuid required
namestring required
domainstring required
timezonestring required
allowedOriginsstring[] required
retentionDaysinteger required
writeKeystring uuid required

Collection-only key; not an account credential

serverWriteKeystring uuid required

Rotatable collection-only secret for trusted server request batches

proxyKeystring uuid required

Server-side secret sent by the site's first-party proxy as X-Slimlytics-Proxy-Key with X-Slimlytics-Client-IP so locations and visitor IDs use the real visitor IP. Keep it out of public repositories; rotate with POST /api/sites/{siteId}/rotate-proxy-key if exposed

antiAdblockServer'caddy' | 'nginx' | 'apache' required
antiAdblockJsPathstring required
antiAdblockBeaconPathstring required
iconMode'initials' | 'favicon' required

Dashboard avatar: initials on a colored tile, or the website's favicon

iconBackgroundstring nullable required

Tile gradient start; null uses an automatic per-domain hue

iconBackgroundEndstring nullable required

Tile gradient end; null keeps the background solid

iconForegroundstring nullable required

Initials color; null uses white

iconUpdatedAtstring date-time nullable required

When the stored favicon last changed; add it to the GET /api/sites/{siteId}/icon URL to bust caches

createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.