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.
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
True to replace DNS records that already exist. Defaults to false.
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
The records that were written or kept.
Fields of each item
createreplacekeepmanualThe records a replace would replace.
For a manual action, why the record is yours to create and what it must be. Null otherwise.
The record to write or keep. Null for a manual action, which the Control Panel cannot write.
Fields
The address the record points at.
Whether Cloudflare proxies the hostname.
The record type, such as A.
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.
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 | not_connected | The outside account this needs is not connected for your company. Connect it first; the message names it. |
422 | confirm_replacements | Existing DNS records would be replaced. Confirm to continue. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
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/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"
]
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/sites/1042/domains/point-dns', [
'confirm_replacements' => false,
'hosts' => [
'harbourandfinch.example.com',
],
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/domains/point-dns', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
confirm_replacements: false,
hosts: [
'harbourandfinch.example.com',
],
}),
});
// 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/domains/point-dns",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"confirm_replacements": False,
"hosts": [
"harbourandfinch.example.com",
],
},
)
data = res.json() if res.content else None{
"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"
}
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "not_connected",
"message": "Connect Cloudflare for this company first",
"reason": "not_connected"
}{
"code": "confirm_replacements",
"dns_plan": {
"actions": [
{
"action": "replace",
"existing": [
{
"content": "198.51.100.9",
"proxied": false,
"type": "A"
}
],
"host": "harbourandfinch.example.com",
"reason": null,
"record": {
"content": "203.0.113.10",
"name": "harbourandfinch.example.com",
"proxied": true,
"type": "A"
}
}
],
"can_apply": true,
"requires_confirmation": true,
"zone": {
"id": "023e105f4ecef8ad9ca31a8372d0c353",
"name": "harbourandfinch.example.com"
}
},
"errors": {
"confirm_replacements": [
"Existing DNS records would be replaced. Confirm to continue."
]
},
"message": "Existing DNS records would be replaced. Confirm to continue.",
"reason": "confirm_replacements"
}{
"code": "rate_limited",
"message": "Too many Cloudflare changes this hour. Try again later.",
"reason": "rate_limited",
"retry_after_seconds": 3600
}{
"message": "string"
}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.