DIdigicert
records - primary - NS

Creates an NS record for a specific primary domain.

This endpoint creates an NS record for a specific primary domain, enabling users to associate the domain with an IP address.</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 a 400 error code with a clear description when requests fail.</br>- Seamless record creation: Facilitates the creation of an NS record in-line with the appropriate schema, ensuring smooth and efficient organization.</br>- Targeted data addition: Leverages the domainId parameter in the URL path to add a new NS record to the specified domain, ensuring accurate and focused modifications for effective domain management.

post/domains/primary/{domainId}/records/NS

Request

Path parameters

domainIdinteger required

Filters data by the domain's unique identifier.

Request body

typestring
namestring
ttlinteger
createdTsstring date-time
modifiedTsstring date-time
systemFlagboolean

Example request

{
  "type": "NS",
  "name": "testns",
  "ttl": 1800,
  "createdTs": "2026-01-01T01:00:00.123456Z",
  "modifiedTs": "2026-01-01T01:00:00.123456Z",
  "region\"": {
    "gtdLocationId": 1,
    "regionName": "NA_WEST",
    "regionLabel": "NA West"
  },
  "values": [
    {
      "id": 1,
      "hostname": "ns200.digicertdns.com.",
      "enabled": true,
      "sortOrder": 1
    }
  ]
}

Response

NS record created successfully.

idinteger
typestring
namestring
ttlinteger
createdTsstring date-time
modifiedTsstring date-time
systemFlagboolean

Example response

{
  "id": 1,
  "type": "NS",
  "name": "testns",
  "ttl": 1800,
  "createdTs": "2026-01-01T01:00:00.123456Z",
  "modifiedTs": "2026-01-01T01:00:00.123456Z",
  "region\"": {
    "gtdLocationId": 1,
    "regionName": "NA_WEST",
    "regionLabel": "NA West"
  },
  "values": [
    {
      "id": 1,
      "hostname": "ns200.digicertdns.com.",
      "enabled": true,
      "sortOrder": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.