CorefinityCorefinityDocs
Open the Control PanelControl Panel
Domains · 6 of 8

Point hostnames at the platform

Writes the DNS records for up to 10 of the site's existing domains in your connected Cloudflare account. Records that already exist are replaced only with confirm_replacements.

POST/api/corestack/sites/{site}/domains/point-dns

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

confirm_replacementsboolean

True to replace DNS records that already exist. Defaults to false.

hostsarray of stringsRequired

Domains the site already has. Up to 10 items.

Returns

200 The records written and the state of each hostname afterwards.

Fields of the 200 answer
appliedarray of objectsRequired

The records that were written or kept.

Fields of each item
actionstringRequired
createreplacekeepmanual
existingarray of objects or nullRequired

The records a replace would replace.

hoststringRequired
reasonstring or nullRequired

For a manual action, why the record is yours to create and what it must be. Null otherwise.

recordobject or nullRequired

The record to write or keep. Null for a manual action, which the Control Panel cannot write.

Fields
contentstringRequired

The address the record points at.

namestringRequired
proxiedbooleanRequired

Whether Cloudflare proxies the hostname.

typestringRequired

The record type, such as A.

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.

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.
409not_connectedThe outside account this needs is not connected for your company. Connect it first; the message names it.
422confirm_replacementsExisting DNS records would be replaced. Confirm to continue.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
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/domains/point-dns \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "confirm_replacements": false,
    "hosts": [
      "harbourandfinch.example.com"
    ]
  }'
{
  "applied": [
    {
      "action": "create",
      "existing": null,
      "host": "harbourandfinch.example.com",
      "reason": null,
      "record": {
        "content": "203.0.113.10",
        "name": "harbourandfinch.example.com",
        "proxied": true,
        "type": "A"
      }
    }
  ],
  "hosts": [
    {
      "cloudflare_zone": {
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "name": "harbourandfinch.example.com",
        "proxied": null,
        "record_id": 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": "2026-11-01T10:14:03Z",
      "expected_ip": "203.0.113.10",
      "host": "harbourandfinch.example.com",
      "ok": true,
      "problems": [],
      "redirects_to": null,
      "role": "primary",
      "tls": {
        "checked_at": "2026-11-06T09:14:41Z",
        "issuer": "Let's Encrypt",
        "not_after": "2026-12-08T05:41:17Z",
        "reason": null,
        "state": "ready"
      }
    }
  ]
}
Try it

Try it is off for this endpointIt overwrites data that cannot be brought back. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT