hosting
GET /v1/sites/{siteId}/cdn/origin-host
The origin hostname a hostname-only CDN pulls from, and the record to add.
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}/cdn/origin-host \
-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
Some CDNs (KeyCDN) refuse an IP address as a pull origin, so the site is given an origin HOSTNAME: o-<hash>.<site domain>, written by us where we run the site's DNS, or added by the customer where they run it; otherwise a neutral fallback name. record is the one A record a customer who runs their own DNS adds, and answering says whether public DNS returns it with the origin address right now. Read-only. Requires sites.view.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
needed | boolean | Yes | Whether the site's current CDN needs a hostname origin. |
hostname | string | Yes | The origin hostname in force, or empty. |
mode | string<, own_dns, customer_dns, origin_domain> | Yes | own_dns we write it on the site's domain; customer_dns the customer added it; origin_domain the neutral fallback name. |
address | string | Yes | The origin server address the hostname must answer with. |
verified_at | string | Yes | When public DNS last answered the hostname with address. |
record | object | Yes | — |
Errors this endpoint can return
401 · 403 · 404 · 422 · 429