Skip to main content

@webframp/cloudflare

v2026.04.22.1

Cloudflare management - zones, DNS records, WAF/firewall rules, Workers, and cache/CDN

Repository

https://github.com/webframp/swamp-extensions

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @webframp/cloudflare

@webframp/cloudflare/zonev2026.03.28.1cloudflare/zone.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringCloudflare API token with Zone read/write permissions
listList all zones in the account
ArgumentTypeDescription
status?enumFilter by zone status
getGet details for a specific zone
ArgumentTypeDescription
zoneIdstringZone ID
get_settingsGet all settings for a zone
ArgumentTypeDescription
zoneIdstringZone ID
update_settingUpdate a specific zone setting
ArgumentTypeDescription
zoneIdstringZone ID
settingstringSetting name (e.g., 'ssl', 'cache_level', 'minify')
valueunknownNew value for the setting
pausePause a zone (disable Cloudflare proxy)
ArgumentTypeDescription
zoneIdstringZone ID
unpauseUnpause a zone (enable Cloudflare proxy)
ArgumentTypeDescription
zoneIdstringZone ID

Resources

zones(infinite)— List of all zones in the account
zone(infinite)— Single zone details
settings(infinite)— Zone settings (caching, SSL, etc.)
@webframp/cloudflare/dnsv2026.03.28.1cloudflare/dns.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringCloudflare API token with DNS read/write permissions
zoneIdstringZone ID to manage DNS records for
listList all DNS records in the zone
ArgumentTypeDescription
type?enumFilter by record type
name?stringFilter by record name (exact match)
getGet a specific DNS record
ArgumentTypeDescription
recordIdstringDNS record ID
createCreate a new DNS record
ArgumentTypeDescription
typeenumRecord type
namestringRecord name (e.g., 'www' or '@' for root)
contentstringRecord content (IP address, hostname, etc.)
ttlnumberTTL in seconds (1 = auto)
proxiedbooleanEnable Cloudflare proxy (orange cloud)
priority?numberPriority (required for MX records)
comment?stringComment for the record
updateUpdate an existing DNS record
ArgumentTypeDescription
recordIdstringDNS record ID to update
typeenumRecord type
namestringRecord name
contentstringRecord content
ttlnumberTTL in seconds (1 = auto)
proxiedbooleanEnable Cloudflare proxy
priority?numberPriority (for MX records)
comment?stringComment for the record
deleteDelete a DNS record
ArgumentTypeDescription
recordIdstringDNS record ID to delete
exportExport all DNS records in BIND format

Resources

records(infinite)— List of DNS records for the zone
record(infinite)— Single DNS record

Files

export(text/plain)— DNS records exported in BIND zone file format
@webframp/cloudflare/wafv2026.03.28.1cloudflare/waf.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringCloudflare API token with Firewall read/write permissions
zoneIdstringZone ID to manage firewall rules for
list_rulesList all firewall rules
create_ruleCreate a new firewall rule
ArgumentTypeDescription
expressionstringFirewall expression (e.g., 'ip.src eq 1.2.3.4' or 'http.request.uri.path contains \
actionenumAction to take when rule matches
description?stringHuman-readable description
priority?numberRule priority (lower = higher priority)
pausedbooleanCreate rule in paused state
delete_ruleDelete a firewall rule
ArgumentTypeDescription
ruleIdstringFirewall rule ID to delete
toggle_rulePause or unpause a firewall rule
ArgumentTypeDescription
ruleIdstringFirewall rule ID
pausedbooleanSet to true to pause, false to enable
list_packagesList WAF packages (managed rulesets)
get_security_eventsGet recent security events (blocks, challenges, etc.)
ArgumentTypeDescription
limitnumberMaximum number of events to fetch

Resources

rules(infinite)— Firewall rules for the zone
rule(infinite)— Single firewall rule
packages(infinite)— WAF packages (managed rulesets)
events(7d)— Recent security events
@webframp/cloudflare/workerv2026.03.28.1cloudflare/worker.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringCloudflare API token with Workers read/write permissions
accountIdstringCloudflare account ID
list_scriptsList all Worker scripts in the account
get_scriptGet Worker script metadata and source code
ArgumentTypeDescription
scriptNamestringWorker script name
deployDeploy a Worker script
ArgumentTypeDescription
scriptNamestringWorker script name
scriptstringJavaScript/TypeScript source code
bindings?arrayEnvironment bindings
delete_scriptDelete a Worker script
ArgumentTypeDescription
scriptNamestringWorker script name to delete
list_routesList Worker routes for a zone
ArgumentTypeDescription
zoneIdstringZone ID
create_routeCreate a Worker route
ArgumentTypeDescription
zoneIdstringZone ID
patternstringRoute pattern (e.g., 'example.com/*')
scriptNamestringWorker script name to execute
delete_routeDelete a Worker route
ArgumentTypeDescription
zoneIdstringZone ID
routeIdstringRoute ID to delete
toggle_subdomainEnable or disable workers.dev subdomain for a Worker script
ArgumentTypeDescription
scriptNamestringWorker script name
enabledbooleanEnable or disable workers.dev subdomain

Resources

scripts(infinite)— List of Worker scripts in the account
script(infinite)— Single Worker script metadata
routes(infinite)— Worker routes for a zone
deployment(infinite)— Worker deployment result

Files

source(application/javascript)— Worker script source code
@webframp/cloudflare/cachev2026.03.28.1cloudflare/cache.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringCloudflare API token with Cache Purge permissions
zoneIdstringZone ID to manage cache for
purge_allPurge all cached content for the zone
purge_urlsPurge specific URLs from cache
ArgumentTypeDescription
urlsarrayList of URLs to purge (max 30)
purge_tagsPurge cache by Cache-Tag headers (Enterprise only)
ArgumentTypeDescription
tagsarrayList of Cache-Tag values to purge
purge_prefixesPurge cache by URL prefixes (Enterprise only)
ArgumentTypeDescription
prefixesarrayList of URL prefixes to purge
get_settingsGet cache-related settings for the zone
set_cache_levelSet the cache level for the zone
ArgumentTypeDescription
levelenumCache level: bypass (no cache), basic, simplified, or aggressive
toggle_dev_modeToggle development mode (bypasses cache for 3 hours)
ArgumentTypeDescription
enabledbooleanEnable or disable development mode
get_analyticsGet cache analytics (hit rate, bandwidth)
ArgumentTypeDescription
sincestringStart time (minutes ago, e.g., '-1440' for last 24h)
untilstringEnd time (minutes ago, '0' for now)

Resources

purge(7d)— Cache purge operation result
settings(infinite)— Cache-related zone settings
analytics(1d)— Cache analytics and hit rates