--- title: Update DNS Record --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [DNS](https://developers.cloudflare.com/api/python/resources/dns) [Records](https://developers.cloudflare.com/api/python/resources/dns/subresources/records) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update DNS Record dns.records.edit(strdns\_record\_id, RecordEditParams\*\*kwargs) -> [RecordResponse]() 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 zone\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20zone_id%20%3E%20(schema)>) dns\_record\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20dns_record_id%20%3E%20(schema)>) name: str Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>)
ttl: TTLParam 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: float Link to this property Literal\[1] 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](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20ttl%20%3E%20(schema)>) type: Literal\["A"] Record type. [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20type%20%3E%20(schema)>) include\_shadow\_metadata: Optional\[[bool]()] Whether to include shadow metadata in the `meta` field of each record in the response. See [Shadowed records](https://developers.cloudflare.com/dns/manage-dns-records/reference/shadowed-records). [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20include_shadow_metadata%20%3E%20(schema)>) comment: Optional\[str] Comments or notes about the DNS record. This field has no effect on DNS responses. [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20comment%20%3E%20(schema)>) content: Optional\[str] A valid IPv4 address. formatipv4 [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20content%20%3E%20(schema)>) private\_routing: Optional\[[bool]()] Enables private network routing to the origin. [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20private_routing%20%3E%20(schema)>) proxied: Optional\[[bool]()] Whether the record is receiving the performance and security benefits of Cloudflare. [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20proxied%20%3E%20(schema)>)
settings: Optional\[ARecordSettings] Settings for the DNS record. ipv4\_only: Optional\[bool] 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 ipv6\_only: Optional\[bool] 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](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20settings%20%3E%20(schema)>) tags: Optional\[Sequence\[[RecordTags]()]] Custom tags for the DNS record. This field has no effect on DNS responses. [Link to this property](<#(resource)%20dns.records%20%3E%20(method)%20edit%20%3E%20(params)%200%20%3E%20(param)%20tags%20%3E%20(schema)>) ##### ReturnsExpand Collapse
RecordResponse One of the following:
class ARecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: ARecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class AAAARecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: AAAARecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class CNAMERecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: CNAMERecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class MXRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: MXRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class NSRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: NSRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class OpenpgpkeyRecord: … id: str Identifier. maxLength32 Link to this property comment: str Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property content: str A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: OpenpgpkeyRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime When the record was last modified. formatdate-time Link to this property name: str 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: OpenpgpkeyRecordSettings Settings for the DNS record. ipv4\_only: Optional\[bool] 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 ipv6\_only: Optional\[bool] 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: List\[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: float Link to this property Literal\[1] 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: Literal\["OPENPGPKEY"] Record type. Link to this property comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class PTRRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: PTRRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class TXTRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: TXTRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class CAARecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: CAARecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class CERTRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: CERTRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class DNSKEYRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: DNSKEYRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class DSRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: DSRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class HTTPSRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: HTTPSRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class LOCRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: LOCRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class NAPTRRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: NAPTRRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class SMIMEARecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: SMIMEARecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class SRVRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: SRVRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class SSHFPRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: SSHFPRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class SVCBRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: SVCBRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class TLSARecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: TLSARecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
class URIRecord: … id: str Identifier. maxLength32 Link to this property created\_on: datetime When the record was created. formatdate-time Link to this property
meta: URIRecordMeta Extra Cloudflare-specific metadata about the record. dead\_glue: Optional\[bool] 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 is\_glue: Optional\[bool] Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property shadowed\_by: Optional\[List\[str]] IDs of the NS records that shadow this record. See Shadowed records. Link to this property shadowed\_records\_count: Optional\[int] Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property modified\_on: datetime 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 comment\_modified\_on: Optional\[datetime] When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property tags\_modified\_on: Optional\[datetime] 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 Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record_response = client.dns.records.edit( dns_record_id="023e105f4ecef8ad9ca31a8372d0c353", zone_id="023e105f4ecef8ad9ca31a8372d0c353", name="example.com", ttl=3600, type="A", ) print(record_response) ``` 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" } } ```