hosting
GET /v1/sites/{siteId}/content
Whether anything has been published to a site yet.
Authentication
Send an API key as a bearer token. The key must carry the sites.view permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/content \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
empty when the site has nothing to serve — on our own servers, no index.php, index.html or index.htm in its document root; on an edge host, no deployment that went live. present when it has content, and unknown when the server could not be asked, which a client must never render as empty. Content uploaded by FTP, SSH or an import counts, because the server is asked rather than the deploy history. An empty site's own domain serves a holding page to visitors until something is published. Not polled: the answer is reused for two minutes. Requires sites.view.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
site_id | string | Yes | — |
state | string<empty, present, unknown> | Yes | unknown means the server could not be asked — never render it as empty. |
Errors this endpoint can return
401 · 403 · 404 · 429