FuseFuse
IntegrationsCloudflareActions

Update Cloudflare DNS record

Fully replace an A, AAAA, CNAME, TXT, or MX record via PUT. Requires DNS Write. Unsafe because Cloudflare does not document update replay idempotency.

Agent markdown

dns_records.update · Cloudflare · v1

Details

Risk
Write
Idempotency
Unsafe
Availability
Default
Exposure
REST, SDK
MCP hints
readOnly=false, destructive=false, idempotent=false, openWorld=true

Scopes

None

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false; oneOf branch 1: required type, name, content; type=A|AAAA|CNAME / branch 2: required type, name, content, proxied; type=A|AAAA|CNAME / branch 3: required type, name, content; type=TXT / branch 4: required type, name, content, priority; type=MX
record_idstringYesminLength 32; maxLength 32; pattern ^[0-9a-fA-F]{32}$
typestringYesenum A | AAAA | CNAME | TXT | MX
namestringYesminLength 1; maxLength 253
contentstringYesminLength 1; maxLength 4096
ttlintegerNominimum 1; maximum 86400
proxiedbooleanNo—
commentstringNomaxLength 100
priorityintegerNominimum 0; maximum 65535

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
idstringYesminLength 32; maxLength 32; pattern ^[0-9a-fA-F]{32}$
namestringYesminLength 1; maxLength 253
typestringYesenum A | AAAA | CNAME | TXT | MX | NS | SRV | CAA | PTR | CERT | DNSKEY | DS | HTTPS | LOC | NAPTR | OPENPGPKEY | SMIMEA | SSHFP | SVCB | TLSA | URI
contentstringYesminLength 1; maxLength 4096
ttlintegerYesminimum 1; maximum 86400
proxiablebooleanYes—
proxiedbooleanYes—
commentstringNomaxLength 100
priorityintegerNominimum 0; maximum 65535
tagsarray<string>NomaxItems 32
tags[]stringYesminLength 1; maxLength 128
created_onstringNominLength 1; maxLength 64
modified_onstringNominLength 1; maxLength 64

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "record_id": {
      "type": "string",
      "minLength": 32,
      "maxLength": 32,
      "pattern": "^[0-9a-fA-F]{32}$"
    },
    "type": {
      "type": "string",
      "enum": [
        "A",
        "AAAA",
        "CNAME",
        "TXT",
        "MX"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 253
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "ttl": {
      "type": "integer",
      "minimum": 1,
      "maximum": 86400
    },
    "proxied": {
      "type": "boolean"
    },
    "comment": {
      "type": "string",
      "maxLength": 100
    },
    "priority": {
      "type": "integer",
      "minimum": 0,
      "maximum": 65535
    }
  },
  "required": [
    "record_id",
    "type",
    "name",
    "content"
  ],
  "oneOf": [
    {
      "required": [
        "type",
        "name",
        "content"
      ],
      "properties": {
        "type": {
          "enum": [
            "A",
            "AAAA",
            "CNAME"
          ]
        }
      }
    },
    {
      "required": [
        "type",
        "name",
        "content",
        "proxied"
      ],
      "properties": {
        "type": {
          "enum": [
            "A",
            "AAAA",
            "CNAME"
          ]
        }
      }
    },
    {
      "required": [
        "type",
        "name",
        "content"
      ],
      "properties": {
        "type": {
          "enum": [
            "TXT"
          ]
        }
      }
    },
    {
      "required": [
        "type",
        "name",
        "content",
        "priority"
      ],
      "properties": {
        "type": {
          "enum": [
            "MX"
          ]
        }
      }
    }
  ]
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "minLength": 32,
      "maxLength": 32,
      "pattern": "^[0-9a-fA-F]{32}$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 253
    },
    "type": {
      "type": "string",
      "enum": [
        "A",
        "AAAA",
        "CNAME",
        "TXT",
        "MX",
        "NS",
        "SRV",
        "CAA",
        "PTR",
        "CERT",
        "DNSKEY",
        "DS",
        "HTTPS",
        "LOC",
        "NAPTR",
        "OPENPGPKEY",
        "SMIMEA",
        "SSHFP",
        "SVCB",
        "TLSA",
        "URI"
      ]
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "ttl": {
      "type": "integer",
      "minimum": 1,
      "maximum": 86400
    },
    "proxiable": {
      "type": "boolean"
    },
    "proxied": {
      "type": "boolean"
    },
    "comment": {
      "type": "string",
      "maxLength": 100
    },
    "priority": {
      "type": "integer",
      "minimum": 0,
      "maximum": 65535
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128
      },
      "maxItems": 32
    },
    "created_on": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "modified_on": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "required": [
    "id",
    "name",
    "type",
    "content",
    "ttl",
    "proxiable",
    "proxied"
  ]
}

On this page

DetailsScopesInputOutputRaw schema