records - primary - PTR

Creates a PTR record for a specific primary domain.

This endpoint creates a PTR 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 a PTR 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 PTR record to the specified domain, ensuring accurate and focused modifications for effective domain management.

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

Request

Path parameters

domainIdinteger required

Filters data by the domain's unique identifier.

Request body

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

Example request

{
  "id": 1,
  "type": "PTR",
  "name": "ptr",
  "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,
      "system": "host1.digicert.com."
    }
  ]
}

Response

PTR record created successfully.

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

Example response

{
  "id": 1,
  "type": "PTR",
  "name": "ptr",
  "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,
      "system": "host1.digicert.com."
    }
  ]
}

Changes

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