---
title: "Point hostnames at the platform"
url: https://docs.corefinity.com/api/reference/domains/point-site-domains-dns
type: endpoint
last_updated: 2026-11-13
feature: domains
related:
  - https://docs.corefinity.com/guides/sites/go-live/add-a-domain.md
  - https://docs.corefinity.com/mcp/tools/corestack_domains_point_dns.md
---
# 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`.

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

- Scope: `write`
- Two-factor: required on your account (all)
- Rate limit: 20 a minute; 60 an hour for each company
- Try it in the console: off. It overwrites data that cannot be brought back. Copy the request and run it yourself when you are sure.

## Path parameters

- `site` (integer, required): The id of a site row. A website's production site and each of its environments has its own id. Digits only.

## Body

- `confirm_replacements` (boolean): True to replace DNS records that already exist. Defaults to `false`.
- `hosts` (array of strings, required): Domains the site already has.

## Request

### curl

```bash
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"
    ]
  }'
```

### PHP

```php
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();
```

### Node

```javascript
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);
```

### Python

```python
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
```

## Responses

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

```json
{
  "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"
      }
    }
  ]
}
```

### 401 No token, or a token that is not valid.

```json
{
  "message": "Unauthenticated."
}
```

### 403 The token lacks the scope (`scope_required`, with the `scope` to use), your company requires two-factor authentication and you have not set it up, or your account has no company that can use Managed Clusters, for example because the company was closed (`company_unavailable` or `company_not_enabled`, whichever the route checks first). For Managed Clusters routes; any other route uses `ForbiddenScopeOrTwoFactor`.

```json
{
  "code": "company_unavailable",
  "message": "Your company is unavailable.",
  "reason": "company_unavailable"
}
```

### 404 The id does not exist or is something you cannot see, or the feature is not on for your company (`feature_off`).

```json
{
  "code": "feature_off",
  "message": "Not found.",
  "reason": "feature_off"
}
```

### 409 `not_connected` (no Cloudflare connection), `no_zone` (the domain is in no connected zone, or Cloudflare is off for the site), `busy` (another Cloudflare change for the company is running), `deleted`, `provisioning` or `managed_elsewhere`.

```json
{
  "code": "not_connected",
  "message": "Connect Cloudflare for this company first",
  "reason": "not_connected"
}
```

### 422 A hostname is not one of the site's domains (`invalid`), the site has no domain attached yet (`preview_only`), existing records would be replaced without `confirm_replacements` (`confirm_replacements`, with the `dns_plan` that would be written), or the plan is too large (`too_many`).

```json
{
  "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"
}
```

### 429 Too many requests (`rate_limited`): the endpoint's request limit, or your company's 60 Cloudflare changes this hour, which the Control Panel and AI assistants spend too. Wait for `Retry-After`, which `retry_after_seconds` repeats.

```json
{
  "code": "rate_limited",
  "message": "Too many Cloudflare changes this hour. Try again later.",
  "reason": "rate_limited",
  "retry_after_seconds": 3600
}
```

### 502 Part of the plan could not be written at Cloudflare. The body says which records failed.

```json
{
  "message": "string"
}
```

## If it is refused

| Status | Reason | What to do |
|---|---|---|
| 401 |  | 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 |  | Read the message; it says what happened. |

## The same task elsewhere

- Guide: [Add a domain](https://docs.corefinity.com/guides/sites/go-live/add-a-domain.md)
- MCP tool: [`corestack_domains_point_dns`](https://docs.corefinity.com/mcp/tools/corestack_domains_point_dns.md)
