zones

Update a zone record

Changed on Sep 17, 2026

Updates the zone record details.

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

Request

Base URL
https://api.dnsimple.com/v2
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/zones/:zone/records/:zonerecord/patch.ts
A function with typed inputs. Its response is checked against the schema.

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

Sep 17, 2026v2faec8b49cc03 Revision changes
- info
  response property data/parent_id deprecated
Jul 11, 2025v206780be0ef17 Revision changes
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status

Operation history (4 revisions)