IntegrationsCloudflareActions
List Cloudflare DNS records
List DNS records in the bound zone with optional exact-name and type filters. One page per call; opaque cursors encode page numbers. Requires DNS Read.
dns_records.list · Cloudflare · v1
Details
Scopes
None
Input
| Name | Type | Required | Constraints |
|---|---|---|---|
(root) | object | Yes | additionalProperties false |
exact_name | string | No | minLength 1; maxLength 253 |
type | string | No | enum A | AAAA | CNAME | TXT | MX | NS | SRV | CAA | PTR | CERT | DNSKEY | DS | HTTPS | LOC | NAPTR | OPENPGPKEY | SMIMEA | SSHFP | SVCB | TLSA | URI |
page_size | integer | No | minimum 1; maximum 100 |
cursor | string | No | minLength 1; maxLength 64 |
Output
| Name | Type | Required | Constraints |
|---|---|---|---|
(root) | object | Yes | additionalProperties false |
records | array<object> | Yes | maxItems 100 |
records[] | object | Yes | additionalProperties false |
records[].id | string | Yes | minLength 32; maxLength 32; pattern ^[0-9a-fA-F]{32}$ |
records[].name | string | Yes | minLength 1; maxLength 253 |
records[].type | string | Yes | enum A | AAAA | CNAME | TXT | MX | NS | SRV | CAA | PTR | CERT | DNSKEY | DS | HTTPS | LOC | NAPTR | OPENPGPKEY | SMIMEA | SSHFP | SVCB | TLSA | URI |
records[].content | string | Yes | minLength 1; maxLength 4096 |
records[].ttl | integer | Yes | minimum 1; maximum 86400 |
records[].proxiable | boolean | Yes | — |
records[].proxied | boolean | Yes | — |
records[].comment | string | No | maxLength 100 |
records[].priority | integer | No | minimum 0; maximum 65535 |
records[].tags | array<string> | No | maxItems 32 |
records[].tags[] | string | Yes | minLength 1; maxLength 128 |
records[].created_on | string | No | minLength 1; maxLength 64 |
records[].modified_on | string | No | minLength 1; maxLength 64 |
next_cursor | string | No | minLength 1; maxLength 64 |
Raw schema
Input
{
"type": "object",
"additionalProperties": false,
"properties": {
"exact_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"
]
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
}
}Output
{
"type": "object",
"additionalProperties": false,
"properties": {
"records": {
"type": "array",
"items": {
"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"
]
},
"maxItems": 100
},
"next_cursor": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"records"
]
}