Update a zone record

Updates the zone record details.

patch/{account}/zones/{zone}/records/{zonerecord}

Path parameters

accountinteger required

The account id

zonestring required

The zone name

zonerecordinteger required

The zone record id

Request body

namestring

contentstring

ttlinteger

The Time To Live (TTL) value for the entry, in seconds.

priorityinteger

regionsZoneRecordRegion[]

integrated_zonesinteger[]

Example request

{
  "content": "mxb.example.com",
  "ttl": 3600,
  "priority": 20,
  "regions": [
    "global"
  ]
}

Response

Successfully updated zone record.

Example response

{
  "data": {
    "id": 1,
    "zone_id": "example.com",
    "parent_id": null,
    "name": "",
    "content": "ns1.dnsimple.com admin.dnsimple.com 1458642070 86400 7200 604800 300",
    "ttl": 3600,
    "priority": null,
    "type": "SOA",
    "regions": [
      "global"
    ],
    "system_record": true,
    "created_at": "2016-03-22T10:20:53Z",
    "updated_at": "2016-10-05T09:26:38Z"
  }
}

Changes

Changed in 3 of the 52 revisions of this API.18117

Jul 11, 2025v206780be0ef1716See the full diff
- ○
  the response property data became required for the status 200
  response-property-became-required
- ○
  the response property data/content became required for the status 200
  response-property-became-required
- ○
  the response property data/created_at became required for the status 200
  response-property-became-required
- ○
  the response property data/id became required for the status 200
  response-property-became-required
- ○
  the response property data/name became required for the status 200
  response-property-became-required
- ○
  the response property data/parent_id became required for the status 200
  response-property-became-required
- ○
  the response property data/priority became required for the status 200
  response-property-became-required
- ○
  the response property data/regions became required for the status 200
  response-property-became-required
- ○
  the response property data/system_record became required for the status 200
  response-property-became-required
- ○
  the response property data/ttl became required for the status 200
  response-property-became-required
- ○
  the response property data/type became required for the status 200
  response-property-became-required
- ○
  the response property data/updated_at became required for the status 200
  response-property-became-required
- ○
  the response property data/zone_id became required for the status 200
  response-property-became-required
- ○
  the response property errors became required for the status 400
  response-property-became-required
- ○
  the response property message became required for the status 400
  response-property-became-required
- ○
  the response property message became required for the status 404
  response-property-became-required
Aug 11, 2023v298a794a9b1911See the full diff
- ○
  added the new optional request property integrated_zones
  new-optional-request-property
Jul 18, 2023v2c8591dcf8c29181See the full diff
- ▲
  the response property data/parent_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data/priority became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property data became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/content became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/created_at became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/id became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/name became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/parent_id became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/priority became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/regions became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/system_record became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/ttl became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/type became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/updated_at became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/zone_id became optional for the status 200
  response-property-became-optional
- ▲
  the response property errors became optional for the status 400
  response-property-became-optional
- ▲
  the response property message became optional for the status 400
  response-property-became-optional
- ▲
  the response property message became optional for the status 404
  response-property-became-optional
- ●
  removed the request property integrated_zones
  request-property-removed
This revision also has 25 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history