DIdigicert
soa

Updates a specific SOA record.

This endpoint updates a specific SOA record, helping users modify its settings or information as needed.</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>- Reliable SOA record updates: Facilitates the modification of a specific SOA record, ensuring accurate and up-to-date information across the system.</br>- Targeted data updates: Leverages the soaId parameter in the URL path to update the specified SOA record, ensuring accurate and focused modifications.

put/soa/{soaId}

Request

Path parameters

soaIdinteger required

Filters data by the SOA record’s unique identifier.

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 updated 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.