Preview a main domain change
Answers what changing the main domain would do: the hostnames, their DNS state, how many database rows mention the old address, and a preview_token valid for 15 minutes. Nothing changes.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Body
The new main domain, as a plain hostname.
Whether the site answers on the www form or the bare form of the new domain. Left out, it follows new_primary.
wwwbareReturns
200 The preview.
Fields of the 200 answer
What stops the change. Empty when nothing does.
Fields
Fields of each item
The connected Cloudflare zone the hostname is in, with its id and name. proxied and record_id are sent as null.
Fields of each item
Format: date-time.
points_hereproxied_hereelsewhereunresolvedunknownThe address the hostname must point at.
True when search engines are asked not to index this hostname. Not sent in the answer of POST …/domains/point-dns.
The hostname this one redirects to. Null when it serves the site itself.
primaryaliaspreviewlegacystoreSent for extra domains on Shopware, and on Magento 2 while Magento store domains are available.
redirectstorefrontA Magento storefront alias's store choice, or the selected choice on the primary. An unmapped alias shows the default store.
Fields
While pending, the store losing this host; null for a new storefront. Omitted otherwise.
mappedpendingunmappedwebsitestorenullThe certificate for the hostname.
Fields
Format: date-time.
readypendingfailednoneTrue when the hostname is ready.
What to fix, in plain words. Empty when ok is true.
Format: date-time.
The site's platform, such as wordpress.
Send this with the change. Valid until expires_at.
What the change would rewrite in the site, by platform. Only the entry of the site's own platform is filled; the others are null. A site on a platform not listed here carries an entry of its own under its platform's name.
Fields
The environment setting that would change. Null on other platforms.
The base URLs that would change. Null on other platforms.
How many database rows mention the old address. Null on other platforms, and when the count is still running (a warning says so).
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | maintenance | The site is in maintenance mode, which blocks this. Switch maintenance mode off first. |
409 | preview_only | The environment has no domain attached yet. Attach one first. |
422 | host_taken | This hostname is already used by another site. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
500 | none | Read the message; it says what happened. |
502 | none | Read the message; it says what happened. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/corestack/sites/1042/url-change/preview \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"new_primary": "harbourandfinch.example.net",
"www": "bare"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/url-change/preview', [
'new_primary' => 'harbourandfinch.example.net',
'www' => 'bare',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/url-change/preview', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
new_primary: 'harbourandfinch.example.net',
www: 'bare',
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/corestack/sites/1042/url-change/preview",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"new_primary": "harbourandfinch.example.net",
"www": "bare",
},
)
data = res.json() if res.content else None{
"blockers": [],
"can_proceed": true,
"checks": {
"advice": null,
"dns_plan": {
"actions": [
{
"action": "keep",
"existing": null,
"host": "harbourandfinch.example.net",
"reason": null,
"record": {
"content": "203.0.113.10",
"name": "harbourandfinch.example.net",
"proxied": true,
"type": "A"
}
}
],
"can_apply": false,
"requires_confirmation": false,
"zone": null
},
"hosts": [
{
"cloudflare_zone": null,
"dns_answers": [
{
"type": "A",
"value": "203.0.113.10"
}
],
"dns_checked_at": "2026-11-06T09:16:05Z",
"dns_detail": null,
"dns_state": "points_here",
"dns_state_since": null,
"expected_ip": "203.0.113.10",
"host": "harbourandfinch.example.net",
"noindex": false,
"ok": true,
"problems": [],
"redirects_to": null,
"role": "primary",
"tls": {
"checked_at": null,
"issuer": null,
"not_after": null,
"reason": null,
"state": "none"
}
}
],
"ok": true
},
"current_primary": "harbourandfinch.example.com",
"expires_at": "2026-11-06T09:46:12Z",
"new_canonical_url": "https://harbourandfinch.example.net",
"new_primary": "harbourandfinch.example.net",
"platform": "wordpress",
"preview_token": "pReViEw-ToKeN-0123456789abcdefghijklmnopqr",
"replacements": {
"laravel": null,
"magento2": null,
"wordpress": {
"by_table": [
{
"column": "post_content",
"rows": 734,
"table": "wp_posts"
}
],
"duration_ms": 18420,
"rows": 1876,
"serialised_safe": true,
"tables": 9
}
},
"warnings": []
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "maintenance",
"message": "Switch the maintenance page off before changing the site's hosts",
"reason": "maintenance"
}{
"code": "host_taken",
"errors": {
"new_primary": [
"This hostname is already used by another site."
]
},
"message": "This hostname is already used by another site.",
"reason": "host_taken"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "Server Error"
}{
"message": "The DNS check could not run. Try again in a moment."
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.