---
title: "Replaces a specific nameserver set."
method: PUT
path: "/nameserversets/{id}"
tags: ["nameserver set"]
---

# Replaces a specific nameserver set.

`PUT /nameserversets/{id}`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/nameserversets/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/nameserversets/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint replaces a specific nameserver set, streamlining updates to the DNS environment without manual reconfiguration.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `400` and `404` error codes with clear descriptions when requests fail.</br>- **Reliable nameserver set replacements:** Facilitates the modification of a specific nameserver set, ensuring accurate and up-to-date information across the system.</br>- **Targeted data replacements:** Leverages the `id` parameter in the URL path to replace the specified nameserver set, ensuring accurate and focused modifications.

## Path parameters

- `id` integer, required

## Request body

- NameserverSetRequest
  - `name` string, required: The name of the nameserver set
  - `isDefault` boolean: Whether this is the default nameserver set
  - `nameservers` union[], required: List of nameservers, can be identified by FQDN, ID, or ID or VanityNameserverFQDN
    - union
      - NameserverByFqdn
        - `fqdn` string, hostname, required: Fully Qualified Domain Name of the nameserver
      - NameserverById
        - `id` integer, required: ID of an existing system nameserver
        - `vanityNameserverFQDN` string: Custom FQDN for the vanity nameserver
  - `resourceGroupsIds` integer[], required: List of associated resource group IDs

## Response `200`

Nameserver set replaced successfully.

- NameserverSetResponse
  - `id` integer
  - `name` string
  - `isSystem` boolean
  - `isDefault` boolean
  - `nameservers` NameserverDetail[]
    - `id` integer
    - `isSystem` boolean
    - `isSecondary` boolean, nullable
    - `fqdn` string, hostname
    - `ipv4` string, ipv4, nullable
    - `ipv6` string, ipv6, nullable
    - `vanityNameserverFQDN` string, hostname, nullable
    - `createdTs` string, date-time
    - `modifiedTs` string, date-time
  - `domains` object[]
  - `resourceGroups` ResourceGroupDetail[]
    - `id` integer
    - `name` string
  - `createdTs` string, date-time
  - `modifiedTs` string, date-time

## Other responses

- `400`: Request is malformed or invalid.
- `404`: Resource not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)