CorefinityCorefinityDocs
Open the Control PanelControl Panel
Domains · 8 of 8

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.

POST/api/corestack/sites/{site}/url-change/preview

Path parameters

siteintegerRequired

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

new_primarystringRequired

The new main domain, as a plain hostname.

wwwstring

Whether the site answers on the www form or the bare form of the new domain. Left out, it follows new_primary.

wwwbare

Returns

200 The preview.

Fields of the 200 answer
blockersarrayRequired

What stops the change. Empty when nothing does.

can_proceedbooleanRequired
checksobjectRequired
Fields
adviceobject or any or nullRequired
dns_planobject or any or nullRequired
hostsarray of objectsRequired
Fields of each item
cloudflare_zoneobject or nullRequired

The connected Cloudflare zone the hostname is in, with its id and name. proxied and record_id are sent as null.

dns_answersarray of objects or nullRequired
Fields of each item
typestring
valuestring
dns_checked_atstring or nullRequired

Format: date-time.

dns_detailstring or nullRequired
dns_statestringRequired
points_hereproxied_hereelsewhereunresolvedunknown
dns_state_sincestring or nullRequired
expected_ipstring or nullRequired

The address the hostname must point at.

hoststringRequired
noindexboolean

True when search engines are asked not to index this hostname. Not sent in the answer of POST …/domains/point-dns.

redirects_tostring or nullRequired

The hostname this one redirects to. Null when it serves the site itself.

rolestringRequired
primaryaliaspreviewlegacystore
servestring

Sent for extra domains on Shopware, and on Magento 2 while Magento store domains are available.

redirectstorefront
storeobject

A Magento storefront alias's store choice, or the selected choice on the primary. An unmapped alias shows the default store.

Fields
codestring or nullRequired
namestring or nullRequired
previousobject or any or null

While pending, the store losing this host; null for a new storefront. Omitted otherwise.

statestringRequired
mappedpendingunmapped
typestring or nullRequired
websitestorenull
tlsobject or nullRequired

The certificate for the hostname.

Fields
checked_atstring or null

Format: date-time.

issuerstring or null
not_afterstring or null
reasonstring or null
statestring
readypendingfailednone
okbooleanRequired

True when the hostname is ready.

problemsarray of stringsRequired

What to fix, in plain words. Empty when ok is true.

okbooleanRequired
current_primarystringRequired
expires_atstring or nullRequired

Format: date-time.

new_canonical_urlstringRequired
new_primarystringRequired
platformstringRequired

The site's platform, such as wordpress.

preview_tokenstring or nullRequired

Send this with the change. Valid until expires_at.

replacementsobjectRequired

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
laravelobject or any or nullRequired

The environment setting that would change. Null on other platforms.

magento2object or any or nullRequired

The base URLs that would change. Null on other platforms.

wordpressobject or any or nullRequired

How many database rows mention the old address. Null on other platforms, and when the count is still running (a warning says so).

warningsarray of stringsRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409maintenanceThe site is in maintenance mode, which blocks this. Switch maintenance mode off first.
409preview_onlyThe environment has no domain attached yet. Attach one first.
422host_takenThis hostname is already used by another site.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
500noneRead the message; it says what happened.
502noneRead 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"
  }'
{
  "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": []
}
Try it

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.

Was this helpful?
Open in ClaudeOpen in ChatGPT