Link a primary server to a secondary zone

Changed on Jul 11, 2025

Link the primary server to a secondary zone.

put/{account}/secondary_dns/primaries/{primaryserver}/link

Request

Base URL
https://api.dnsimple.com/v2
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/secondary_dns/primaries/:primaryserver/link/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

accountinteger required

The account id

primaryserverinteger required

The primary server id

Response

Primary Server linked.

Example response

{
  "data": {
    "id": 1,
    "account_id": 2020,
    "name": "Primary Server",
    "ip": "1.1.1.1",
    "port": 4567,
    "linked_secondary_zones": [
      "example.com"
    ],
    "created_at": "2016-08-11T10:16:03Z",
    "updated_at": "2016-08-11T10:16:03Z"
  }
}

Changes

Jul 11, 2025v206780be0ef17 Revision changes
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
Jul 18, 2023v2c8591dcf8c29 Revision changes
- breaking
  the response property became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property / became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status

Operation history