--- title: Update DNS Record --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [DNS](https://developers.cloudflare.com/api/go/resources/dns) [Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update DNS Record client.DNS.Records.Edit(ctx, dnsRecordID, params) (\*[RecordResponse](), error) PATCH/zones/{zone\_id}/dns\_records/{dns\_record\_id} Update an existing DNS record. Notes: - A/AAAA records cannot exist on the same name as CNAME records. - NS records cannot exist on the same name as any other record type. - Domain names are always represented in Punycode, even if Unicode characters were used when creating the record. ##### 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 dnsRecordID string Identifier. maxLength32 [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%20default%20%3E%20(param)%20dns_record_id%20%3E%20(schema)>)
params RecordEditParams ZoneID param.Field\[string] Path param: Identifier. maxLength32 Link to this property ARecord param.Field\[ARecord] Body param Link to this property 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. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200>) ##### ReturnsExpand Collapse
type RecordResponse interface{…} One of the following:
type RecordResponseARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseAAAARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseCNAMERecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseMXRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseNSRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseOpenpgpkeyRecord struct{…} ID string Identifier. maxLength32 Link to this property Comment string Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content string A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property Proxied bool Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
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. Link to this property 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. Link to this property
Link to this property Tags \[]RecordTags Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
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 Link to this property 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. Link to this property
Link to this property Type RecordResponseOpenpgpkeyRecordType Record type. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponsePTRRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseTXTRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseCAARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseCERTRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseDNSKEYRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseDSRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseHTTPSRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseLOCRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseNAPTRRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSMIMEARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSRVRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSSHFPRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSVCBRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseTLSARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseURIRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
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. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20record_response%20%3E%20(schema)>) ### Update DNS Record Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/dns" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) recordResponse, err := client.DNS.Records.Edit( context.TODO(), "023e105f4ecef8ad9ca31a8372d0c353", dns.RecordEditParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Body: dns.ARecordParam{ Name: cloudflare.F("example.com"), TTL: cloudflare.F(dns.TTL1), Type: cloudflare.F(dns.ARecordTypeA), }, }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", recordResponse) } ``` 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": { "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": { "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" } } ```