---
title: "Update a zone record"
method: PATCH
path: "/{account}/zones/{zone}/records/{zonerecord}"
tags: ["zones"]
---

# Update a zone record

`PATCH /{account}/zones/{zone}/records/{zonerecord}`

Updates the zone record details.

## Path parameters

- `account` integer, required
- `zone` string, required
- `zonerecord` integer, required

## Request body

- object
  - `name` string
  - `content` string
  - `ttl` integer — The Time To Live (TTL) value for the entry, in seconds.
  - `priority` integer
  - `regions` ZoneRecordRegion[]
  - `integrated_zones` integer[]

## Response `200`

Successfully updated zone record.

- object
  - `data` ZoneRecord, required — A single DNS record in a zone.
    - `id` integer, required — The unique identifier for the record.
    - `zone_id` string, required — The unique identifier of the zone this record belongs to
    - `parent_id` integer, nullable, required — If present represents the zone record this record relates to. The parent record is the master record, when the parent is updated or deleted the related record is also updated or deleted. An example of child record is the TXT descriptive record created for an ALIAS record.
    - `name` string, required — The name of the record (e.g., "www" for www.example.com).
    - `content` string, required — The content/value of the record (e.g., IP address for A records, hostname for CNAME records).
    - `ttl` integer, required — The Time To Live (TTL) value for the entry, in seconds.
    - `priority` integer, nullable, required — The priority value for MX and SRV records. Lower values have higher priority.
    - `type` 'A' | 'AAAA' | 'ALIAS' | 'CAA' | 'CNAME' | 'DNSKEY' | 'DS' | 'HINFO' | 'MX' | 'NAPTR' | 'NS' | 'POOL' | 'PTR' | 'SOA' | 'SPF' | 'SRV' | 'SSHFP' | 'TXT' | 'URL', required — The type of DNS record. Supported DNS record types are listed below. Note that some record types may only be available on specific plans.
    - `regions` ZoneRecordRegion[], required — The regions where this record is active. If empty, the record is active in all regions.
    - `system_record` boolean, required — Returns true if a record is a system generated record and thus is not modifiable.
    - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
    - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.

## Other responses

- `400` — A required parameter is missing or the request is invalid.
- `404` — The requested resource doesn't exist.

## Changes

- **2025-07-11** (v2) `06780be0ef17` — 16 info
  - the response property `data` became required for the status `200`
  - the response property `data/content` became required for the status `200`
  - the response property `data/created_at` became required for the status `200`
  - the response property `data/id` became required for the status `200`
  - …12 more
- **2023-08-11** (v2) `98a794a9b191` — 1 info
  - added the new optional request property `integrated_zones`
- **2023-07-18** (v2) `c8591dcf8c29` — 18 breaking, 1 warning
  - the response property `data/parent_id` became nullable for the status `200`
  - the response property `data/priority` became nullable for the status `200`
  - the response property `data` became optional for the status `200`
  - the response property `data/content` became optional for the status `200`
  - …15 more

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/zones/:zone/records/:zonerecord/patch.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)