Skip to main content
PATCH
Update Cloudflare Dns Record

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Path Parameters

zone_id
string
required
record_id
string
required

Query Parameters

credential_name
string | null

Which connected Cloudflare credential to use. Omit when the organisation has exactly one.

Body

application/json
content
string
required

The record's new value. Always required, so an edit states what the record points at.

ttl
integer | null

Record TTL in seconds (60-86400), or 1 for automatic. Omit to keep the record's current TTL; send null to reset it to automatic.

proxied
boolean | null

Whether Cloudflare's proxy fronts the record. Omit to keep the record's current setting.

priority
integer | null

Priority for MX and SRV records. Omit to keep the record's current priority.

comment
string | null

Comment stored on the record. Omit to keep the record's current comment.

name
string | null

Accepted only so a mismatch can be refused: a DNS record's name cannot be changed. Send it to assert the record's identity, or omit it. Delete and re-create to rename.

record_type
string | null

Accepted only so a mismatch can be refused: a DNS record's type cannot be changed. Delete and re-create to change it.

Response

Successful Response

id
string
required
zone_id
string
required
zone_name
string
required
name
string
required
record_type
string
required
content
string
required
ttl
integer
required
is_ttl_automatic
boolean
required
proxied
boolean
required
proxiable
boolean
required
tags
string[]
required
managed_by
enum<string>
required
Available options:
ankra,
external
priority
integer | null
comment
string
created_on
string
modified_on
string