hosting
POST /v1/sites/{siteId}/cdn/swap/check
Check now whether the domain uses the nameservers a CDN move is waiting for.
Authentication
Send an API key as a bearer token. The key must carry the hosting.cdn.manage 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 POST https://api.zinndigital.com/v1/sites/{siteId}/cdn/swap/check \
-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
"Check now" for a move in awaiting_delegation. Reads the domain's nameservers as the public internet sees them RIGHT NOW (live_nameservers; null when the public resolver did not answer, which is "we could not see", never "nothing is set") against the ones the move needs (nameservers). When they match, delegated is true and the move carries on at once instead of at its next ten-minute check. When the site has no move waiting on its nameservers (it finished, or never waited), the answer is waiting: false and the screen should re-read the move. Requires hosting.cdn.manage.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
data | CdnSwapCheck | Yes | "Check now" for a CDN move waiting on the domain's nameservers (CDNMOVE): what the domain uses right now against what the move needs. |
Errors this endpoint can return
401 · 403 · 404 · 429