API Reference

DNS

Records

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Batch DNS Records

client.DNS.Records.Batch(ctx, params) (*RecordBatchResponse, error)

POST/zones/{zone_id}/dns_records/batch

Send a Batch of DNS Record API calls to be executed together.

Notes:

• Although Cloudflare will execute the batched operations in a single database transaction, Cloudflare’s distributed KV store must treat each record change as a single key-value pair. This means that the propagation of changes is not atomic. See the documentation for more information.

• The operations you specify within the /batch request body are always executed in the following order:

  • Deletes
  • Patches
  • Puts
  • Posts

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

DNS Write

ParametersExpand Collapse

params RecordBatchParams

ZoneID param.Field[string]

Path param: Identifier.

maxLength32

IncludeShadowMetadata param.Field[bool]Optional

Query param: Whether to include shadow metadata in the meta field of each record in the response. See Shadowed records.

Deletes param.Field[[]RecordBatchParamsDelete]Optional

Body param

ID string

Identifier.

maxLength32

Patches param.Field[[]BatchPatch]Optional

Body param

BatchPatchARecord

ID string

Identifier.

maxLength32

BatchPatchAAAARecord

ID string

Identifier.

maxLength32

BatchPatchCNAMERecord

ID string

Identifier.

maxLength32

BatchPatchMXRecord

ID string

Identifier.

maxLength32

BatchPatchNSRecord

ID string

Identifier.

maxLength32

BatchPatchOpenpgpkeyRecord

ID string

Identifier.

maxLength32

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type BatchPatchOpenpgpkeyRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings BatchPatchOpenpgpkeyRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

BatchPatchPTRRecord

ID string

Identifier.

maxLength32

BatchPatchTXTRecord

ID string

Identifier.

maxLength32

BatchPatchCAARecord

ID string

Identifier.

maxLength32

BatchPatchCERTRecord

ID string

Identifier.

maxLength32

BatchPatchDNSKEYRecord

ID string

Identifier.

maxLength32

BatchPatchDSRecord

ID string

Identifier.

maxLength32

BatchPatchHTTPSRecord

ID string

Identifier.

maxLength32

BatchPatchLOCRecord

ID string

Identifier.

maxLength32

BatchPatchNAPTRRecord

ID string

Identifier.

maxLength32

BatchPatchSMIMEARecord

ID string

Identifier.

maxLength32

BatchPatchSRVRecord

ID string

Identifier.

maxLength32

BatchPatchSSHFPRecord

ID string

Identifier.

maxLength32

BatchPatchSVCBRecord

ID string

Identifier.

maxLength32

BatchPatchTLSARecord

ID string

Identifier.

maxLength32

BatchPatchURIRecord

ID string

Identifier.

maxLength32

Posts param.Field[[]RecordBatchParamsPost]Optional

Body param

type ARecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type ARecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A valid IPv4 address.

formatipv4

PrivateRouting boolOptional

Enables private network routing to the origin.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings ARecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type AAAARecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type AAAARecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A valid IPv6 address.

formatipv6

PrivateRouting boolOptional

Enables private network routing to the origin.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings AAAARecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type CNAMERecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type CNAMERecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A valid hostname. Must not match the record’s name.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings CNAMERecordSettingsOptional

Settings for the DNS record.

FlattenCNAME boolOptional

If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type MXRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type MXRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A valid mail server hostname.

formathostname

Priority float64Optional

Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.

maximum65535

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings MXRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type NSRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type NSRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A valid name server host name.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings NSRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type RecordBatchParamsPostsDNSRecordsOpenpgpkeyRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type RecordBatchParamsPostsDNSRecordsOpenpgpkeyRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings RecordBatchParamsPostsDNSRecordsOpenpgpkeyRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type PTRRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type PTRRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Domain name pointing to the address.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings PTRRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type TXTRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type TXTRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Text content for the record. The content must consist of quoted “character strings” (RFC 1035), each with a length of up to 255 bytes. Strings exceeding this allowed maximum length are automatically split.

Learn more at https://www.cloudflare.com/learning/dns/dns-records/dns-txt-record/.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings TXTRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type CAARecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type CAARecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted CAA content. See ‘data’ to set CAA properties.

Data CAARecordDataOptional

Components of a CAA record.

Flags float64Optional

Flags for the CAA record.

maximum255

minimum0

Tag stringOptional

Name of the property controlled by this record (e.g.: issue, issuewild, iodef).

Value stringOptional

Value of the record. This field’s semantics depend on the chosen tag.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings CAARecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type CERTRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type CERTRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted CERT content. See ‘data’ to set CERT properties.

Data CERTRecordDataOptional

Components of a CERT record.

Algorithm float64Optional

Algorithm.

maximum255

minimum0

Certificate stringOptional

Certificate.

KeyTag float64Optional

Key Tag.

maximum65535

minimum0

Type float64Optional

Type.

maximum65535

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings CERTRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type DNSKEYRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type DNSKEYRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted DNSKEY content. See ‘data’ to set DNSKEY properties.

Data DNSKEYRecordDataOptional

Components of a DNSKEY record.

Algorithm float64Optional

Algorithm.

maximum255

minimum0

Flags float64Optional

Flags.

maximum65535

minimum0

Protocol float64Optional

Protocol.

maximum255

minimum0

PublicKey stringOptional

Public Key.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings DNSKEYRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type DSRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type DSRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted DS content. See ‘data’ to set DS properties.

Data DSRecordDataOptional

Components of a DS record.

Algorithm float64Optional

Algorithm.

maximum255

minimum0

Digest stringOptional

Digest.

DigestType float64Optional

Digest Type.

maximum255

minimum0

KeyTag float64Optional

Key Tag.

maximum65535

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings DSRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type HTTPSRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type HTTPSRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted HTTPS content. See ‘data’ to set HTTPS properties.

Data HTTPSRecordDataOptional

Components of a HTTPS record.

Priority float64Optional

Priority.

maximum65535

minimum0

Target stringOptional

Target.

Value stringOptional

Value.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings HTTPSRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type LOCRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type LOCRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted LOC content. See ‘data’ to set LOC properties.

Data LOCRecordDataOptional

Components of a LOC record.

Altitude float64Optional

Altitude of location in meters.

maximum42849672.95

minimum-100000

LatDegrees float64Optional

Degrees of latitude.

maximum90

minimum0

LatDirection LOCRecordDataLatDirectionOptional

Latitude direction.

One of the following:

const LOCRecordDataLatDirectionN LOCRecordDataLatDirection = "N"

const LOCRecordDataLatDirectionS LOCRecordDataLatDirection = "S"

LatMinutes float64Optional

Minutes of latitude.

maximum59

minimum0

LatSeconds float64Optional

Seconds of latitude.

maximum59.999

minimum0

LongDegrees float64Optional

Degrees of longitude.

maximum180

minimum0

LongDirection LOCRecordDataLongDirectionOptional

Longitude direction.

One of the following:

const LOCRecordDataLongDirectionE LOCRecordDataLongDirection = "E"

const LOCRecordDataLongDirectionW LOCRecordDataLongDirection = "W"

LongMinutes float64Optional

Minutes of longitude.

maximum59

minimum0

LongSeconds float64Optional

Seconds of longitude.

maximum59.999

minimum0

PrecisionHorz float64Optional

Horizontal precision of location.

maximum90000000

minimum0

PrecisionVert float64Optional

Vertical precision of location.

maximum90000000

minimum0

Size float64Optional

Size of location in meters.

maximum90000000

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings LOCRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type NAPTRRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type NAPTRRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted NAPTR content. See ‘data’ to set NAPTR properties.

Data NAPTRRecordDataOptional

Components of a NAPTR record.

Flags stringOptional

Flags.

Order float64Optional

Order.

maximum65535

minimum0

Preference float64Optional

Preference.

maximum65535

minimum0

Regex stringOptional

Regex.

Replacement stringOptional

Replacement.

Service stringOptional

Service.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings NAPTRRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type SMIMEARecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type SMIMEARecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted SMIMEA content. See ‘data’ to set SMIMEA properties.

Data SMIMEARecordDataOptional

Components of a SMIMEA record.

Certificate stringOptional

Certificate.

MatchingType float64Optional

Matching Type.

maximum255

minimum0

Selector float64Optional

Selector.

maximum255

minimum0

Usage float64Optional

Usage.

maximum255

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings SMIMEARecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type SRVRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type SRVRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Priority, weight, port, and SRV target. See ‘data’ for setting the individual component values.

Data SRVRecordDataOptional

Components of a SRV record.

Port float64Optional

The port of the service.

maximum65535

minimum0

Priority float64Optional

Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.

maximum65535

minimum0

Target stringOptional

A valid hostname.

formathostname

Weight float64Optional

The record weight.

maximum65535

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings SRVRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type SSHFPRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type SSHFPRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted SSHFP content. See ‘data’ to set SSHFP properties.

Data SSHFPRecordDataOptional

Components of a SSHFP record.

Algorithm float64Optional

Algorithm.

maximum255

minimum0

Fingerprint stringOptional

Fingerprint.

Type float64Optional

Type.

maximum255

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings SSHFPRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type SVCBRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type SVCBRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted SVCB content. See ‘data’ to set SVCB properties.

Data SVCBRecordDataOptional

Components of a SVCB record.

Priority float64Optional

Priority.

maximum65535

minimum0

Target stringOptional

Target.

Value stringOptional

Value.

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings SVCBRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type TLSARecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type TLSARecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted TLSA content. See ‘data’ to set TLSA properties.

Data TLSARecordDataOptional

Components of a TLSA record.

Certificate stringOptional

Certificate.

MatchingType float64Optional

Matching Type.

maximum255

minimum0

Selector float64Optional

Selector.

maximum255

minimum0

Usage float64Optional

Usage.

maximum255

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings TLSARecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

type URIRecord struct{…}

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type URIRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

Formatted URI content. See ‘data’ to set URI properties.

Data URIRecordDataOptional

Components of a URI record.

Target stringOptional

The record content.

Weight float64Optional

The record weight.

maximum65535

minimum0

Priority float64Optional

Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.

maximum65535

minimum0

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings URIRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

Puts param.Field[[]BatchPut]Optional

Body param

BatchPutARecord

ID string

Identifier.

maxLength32

BatchPutAAAARecord

ID string

Identifier.

maxLength32

BatchPutCNAMERecord

ID string

Identifier.

maxLength32

BatchPutMXRecord

ID string

Identifier.

maxLength32

BatchPutNSRecord

ID string

Identifier.

maxLength32

BatchPutOpenpgpkeyRecord

ID string

Identifier.

maxLength32

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type BatchPutOpenpgpkeyRecordType

Record type.

Comment stringOptional

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content stringOptional

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

Proxied boolOptional

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings BatchPutOpenpgpkeyRecordSettingsOptional

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTagsOptional

Custom tags for the DNS record. This field has no effect on DNS responses.

BatchPutPTRRecord

ID string

Identifier.

maxLength32

BatchPutTXTRecord

ID string

Identifier.

maxLength32

BatchPutCAARecord

ID string

Identifier.

maxLength32

BatchPutCERTRecord

ID string

Identifier.

maxLength32

BatchPutDNSKEYRecord

ID string

Identifier.

maxLength32

BatchPutDSRecord

ID string

Identifier.

maxLength32

BatchPutHTTPSRecord

ID string

Identifier.

maxLength32

BatchPutLOCRecord

ID string

Identifier.

maxLength32

BatchPutNAPTRRecord

ID string

Identifier.

maxLength32

BatchPutSMIMEARecord

ID string

Identifier.

maxLength32

BatchPutSRVRecord

ID string

Identifier.

maxLength32

BatchPutSSHFPRecord

ID string

Identifier.

maxLength32

BatchPutSVCBRecord

ID string

Identifier.

maxLength32

BatchPutTLSARecord

ID string

Identifier.

maxLength32

BatchPutURIRecord

ID string

Identifier.

maxLength32

ReturnsExpand Collapse

type RecordBatchResponse struct{…}

Deletes []RecordResponseOptional

One of the following:

type RecordResponseARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseAAAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseAAAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCNAMERecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCNAMERecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseMXRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseMXRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseOpenpgpkeyRecord struct{…}

ID string

Identifier.

maxLength32

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content string

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseOpenpgpkeyRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

Proxied bool

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings RecordResponseOpenpgpkeyRecordSettings

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTags

Custom tags for the DNS record. This field has no effect on DNS responses.

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type RecordResponseOpenpgpkeyRecordType

Record type.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponsePTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponsePTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTXTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTXTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCERTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCERTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDNSKEYRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDNSKEYRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseHTTPSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseHTTPSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseLOCRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseLOCRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNAPTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNAPTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSMIMEARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSMIMEARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSRVRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSRVRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSSHFPRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSSHFPRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSVCBRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSVCBRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTLSARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTLSARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseURIRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseURIRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

Patches []RecordResponseOptional

One of the following:

type RecordResponseARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseAAAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseAAAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCNAMERecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCNAMERecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseMXRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseMXRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseOpenpgpkeyRecord struct{…}

ID string

Identifier.

maxLength32

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content string

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseOpenpgpkeyRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

Proxied bool

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings RecordResponseOpenpgpkeyRecordSettings

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTags

Custom tags for the DNS record. This field has no effect on DNS responses.

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type RecordResponseOpenpgpkeyRecordType

Record type.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponsePTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponsePTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTXTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTXTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCERTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCERTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDNSKEYRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDNSKEYRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseHTTPSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseHTTPSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseLOCRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseLOCRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNAPTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNAPTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSMIMEARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSMIMEARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSRVRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSRVRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSSHFPRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSSHFPRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSVCBRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSVCBRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTLSARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTLSARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseURIRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseURIRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

Posts []RecordResponseOptional

One of the following:

type RecordResponseARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseAAAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseAAAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCNAMERecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCNAMERecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseMXRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseMXRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseOpenpgpkeyRecord struct{…}

ID string

Identifier.

maxLength32

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content string

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseOpenpgpkeyRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

Proxied bool

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings RecordResponseOpenpgpkeyRecordSettings

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTags

Custom tags for the DNS record. This field has no effect on DNS responses.

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type RecordResponseOpenpgpkeyRecordType

Record type.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponsePTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponsePTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTXTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTXTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCERTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCERTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDNSKEYRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDNSKEYRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseHTTPSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseHTTPSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseLOCRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseLOCRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNAPTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNAPTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSMIMEARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSMIMEARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSRVRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSRVRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSSHFPRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSSHFPRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSVCBRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSVCBRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTLSARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTLSARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseURIRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseURIRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

Puts []RecordResponseOptional

One of the following:

type RecordResponseARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseAAAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseAAAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCNAMERecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCNAMERecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseMXRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseMXRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseOpenpgpkeyRecord struct{…}

ID string

Identifier.

maxLength32

Comment string

Comments or notes about the DNS record. This field has no effect on DNS responses.

Content string

A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1)

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseOpenpgpkeyRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Name string

Complete DNS record name, including the zone name, in Punycode.

maxLength255

minLength1

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

Proxied bool

Whether the record is receiving the performance and security benefits of Cloudflare.

Settings RecordResponseOpenpgpkeyRecordSettings

Settings for the DNS record.

IPV4Only boolOptional

When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

IPV6Only boolOptional

When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6.

Tags []RecordTags

Custom tags for the DNS record. This field has no effect on DNS responses.

TTL TTL

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

One of the following:

float64

type TTL float64

Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones.

Type RecordResponseOpenpgpkeyRecordType

Record type.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponsePTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponsePTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTXTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTXTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCAARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCAARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseCERTRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseCERTRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDNSKEYRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDNSKEYRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseDSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseDSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseHTTPSRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseHTTPSRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseLOCRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseLOCRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseNAPTRRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseNAPTRRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSMIMEARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSMIMEARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSRVRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSRVRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSSHFPRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSSHFPRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseSVCBRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseSVCBRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseTLSARecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseTLSARecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

type RecordResponseURIRecord struct{…}

ID string

Identifier.

maxLength32

CreatedOn Time

When the record was created.

formatdate-time

Meta RecordResponseURIRecordMeta

Extra Cloudflare-specific metadata about the record.

DeadGlue boolOptional

Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records.

IsGlue boolOptional

Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records.

ShadowedBy []stringOptional

IDs of the NS records that shadow this record. See Shadowed records.

ShadowedRecordsCount int64Optional

Number of records shadowed by this NS delegation. See Shadowed records.

maximum10000

minimum0

ModifiedOn Time

When the record was last modified.

formatdate-time

Proxiable bool

Whether the record can be proxied by Cloudflare or not.

CommentModifiedOn TimeOptional

When the record comment was last modified. Omitted if there is no comment.

formatdate-time

TagsModifiedOn TimeOptional

When the record tags were last modified. Omitted if there are no tags.

formatdate-time

Batch DNS Records

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/dns"
  "github.com/stainless-sdks/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.DNS.Records.Batch(context.TODO(), dns.RecordBatchParams{
    ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Deletes)
}

200 example

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "deletes": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ],
    "patches": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ],
    "posts": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ],
    "puts": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ]
  }
}

Returns Examples

200 example

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "deletes": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ],
    "patches": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ],
    "posts": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ],
    "puts": [
      {
        "name": "example.com",
        "ttl": 3600,
        "type": "A",
        "comment": "Domain verification record",
        "content": "198.51.100.4",
        "private_routing": true,
        "proxied": true,
        "settings": {
          "ipv4_only": true,
          "ipv6_only": true
        },
        "tags": [
          "owner:dns-team"
        ],
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "created_on": "2014-01-01T05:20:00.12345Z",
        "meta": {
          "dead_glue": true,
          "is_glue": true,
          "shadowed_by": [
            "372e67954025e0ba6aaa6d586b9e0b59"
          ],
          "shadowed_records_count": 42
        },
        "modified_on": "2014-01-01T05:20:00.12345Z",
        "proxiable": true,
        "comment_modified_on": "2024-01-01T05:20:00.12345Z",
        "tags_modified_on": "2025-01-01T05:20:00.12345Z"
      }
    ]
  }
}