DIdigicert
soa

Creates a new SOA record.

This endpoint creates a new SOA record, allowing users to define the authoritative DNS settings for a domain.</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 SOA record creation: Facilitates the creation of a SOA record in-line with the appropriate schema, ensuring smooth and efficient organization.

post/soa

Request

Request body

idinteger
namestring
primaryNameserverstring
emailstring
ttlinteger
startingSerialstring
refreshinteger
retryinteger
expirestring
negativeCacheinteger
createdTsstring
modifiedTsstring

Example request

{
  "id": 1,
  "name": "mySoa",
  "primaryNameserver": "ns10.organizationdns.com",
  "email": "user@organization.com",
  "ttl": 86400,
  "startingSerial": "2024061202",
  "refresh": 120,
  "retry": 3600,
  "expire": "1209600",
  "negativeCache": 180,
  "createdTs": "2024-02-01 14:02:58.325993",
  "modifiedTs": "2024-02-01 14:02:58.325993",
  "domains": [
    {
      "id": 1,
      "name": "example.com"
    }
  ]
}

Response

SOA record created successfully.

idinteger
namestring
primaryNameserverstring
emailstring
ttlinteger
startingSerialstring
refreshinteger
retryinteger
expirestring
negativeCacheinteger
createdTsstring
modifiedTsstring
isDefaultboolean

Example response

{
  "id": 1,
  "name": "mySoa",
  "primaryNameserver": "ns10.organizationdns.com",
  "email": "user@organization.com",
  "ttl": 86400,
  "startingSerial": "2024061202",
  "refresh": 120,
  "retry": 3600,
  "expire": "1209600",
  "negativeCache": 180,
  "createdTs": "2024-02-01 14:02:58.325993",
  "modifiedTs": "2024-02-01 14:02:58.325993",
  "domains": [
    {
      "id": 1,
      "name": "example.com"
    }
  ]
}

Changes

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