Skip to main content
← back to extensions

Cloudflare/email Routing

@webframp/cloudflare/email-routingv2026.07.27.1· 4d agoMODELS
01README

Cloudflare Email Routing — rules, addresses, catch-all, DNS setup

02Release Notes

2026.07.27.1

Fixed: Regenerated from scripts/cloudflare-codegen after two generator bugs were repaired (webframp/swamp-extensions#284).

  1. Methods referencing an undeclared path parameter did not compile. The generator derived a method's arguments schema and execute signature from the OpenAPI parameters list, but built the request URL from the path template. Where the Cloudflare spec omits a declaration for a {placeholder} — which it does in several places — the result was a method with arguments: z.object({}) and an unused _args parameter whose body still interpolated args.<name>. Those methods failed type checking and were uncallable even if they had compiled, because the argument was never declared. Path-template placeholders are now unioned into the declared parameters, so the schema, the signature, and the body agree.

  2. Generated tests could request a URL the mock server did not serve. Test arguments merged the request-body fixture over the path-parameter values, so a body property sharing a name with a path parameter (commonly id) substituted its own example value into the URL. The request then missed the mock and failed with Cloudflare API error: Not found. Path parameters now take precedence, matching what the generated model already does by excluding path-parameter names from the request body.

Upgrade note: No API surface change and no method was added or removed. If this extension type-checked and tested cleanly before, its behavior is unchanged and only the version moved. Extensions that previously failed deno check or deno task test now pass.

03Models1
@webframp/cloudflare/email-routingv2026.07.27.1cloudflare/email_routing.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringCloudflare API token
zoneIdstringCloudflare zone ID
fn get_dmarc_reports_status()
Get DMARC Report Status
fn update_configure_dmarc_reports(enabled?: boolean, skip_wizard?: boolean)
Configure DMARC Reports
ArgumentTypeDescription
enabled?booleanEnable or disable DMARC reports for this zone
skip_wizard?booleanSkip the DMARC setup wizard
fn get_inspect_spf()
Inspect SPF Record
fn get_email_routing_settings()
Get Email Routing settings
fn update_email_routing_settings_replace_email_routing_settings(enabled?: union, skip_wizard?: union, support_subaddress?: union)
Update Email Routing settings
ArgumentTypeDescription
enabled?unionState of your zone Email Routing settings. No-op on this endpoint - use `POST...
skip_wizard?unionFlag to check if the user skipped the configuration wizard.
support_subaddress?unionWhether subaddressing (plus-addressing) is honored when matching incoming mai...
fn update_email_routing_settings(enabled?: union, skip_wizard?: union, support_subaddress?: union)
Update Email Routing settings
ArgumentTypeDescription
enabled?unionState of your zone Email Routing settings. No-op on this endpoint - use `POST...
skip_wizard?unionFlag to check if the user skipped the configuration wizard.
support_subaddress?unionWhether subaddressing (plus-addressing) is honored when matching incoming mai...
fn get_email_routing_settings_email_routing_dns_settings(subdomain?: string)
Email Routing - DNS settings
ArgumentTypeDescription
subdomain?string
fn create_email_routing_settings_enable_email_routing_dns(name?: unknown)
Enable Email Routing
ArgumentTypeDescription
name?unknown
fn update_email_routing_settings_unlock_email_routing_dns(name?: unknown)
Unlock Email Routing
ArgumentTypeDescription
name?unknown
fn delete_email_routing_settings_disable_email_routing_dns(name?: unknown)
Disable Email Routing
ArgumentTypeDescription
name?unknown
fn list_routing_rules(page?: number, per_page?: number, enabled?: boolean)
List routing rules
ArgumentTypeDescription
page?number
per_page?number
enabled?boolean
fn create_routing_rule(actions: unknown, enabled?: unknown, matchers: unknown, name?: unknown, owner_worker_tag?: unknown, priority?: unknown, source?: unknown)
Create routing rule
ArgumentTypeDescription
actionsunknown
enabled?unknown
matchersunknown
name?unknown
owner_worker_tag?unknown
priority?unknown
source?unknown
fn get_catch_all_rule()
Get catch-all rule
fn update_catch_all_rule(actions: unknown, enabled?: unknown, matchers: unknown, name?: unknown, owner_worker_tag?: unknown, source?: unknown)
Update catch-all rule
ArgumentTypeDescription
actionsunknown
enabled?unknown
matchersunknown
name?unknown
owner_worker_tag?unknown
source?unknown
fn get_routing_rule(rule_identifier: string)
Get routing rule
ArgumentTypeDescription
rule_identifierstring
fn update_routing_rule(rule_identifier: string, actions: unknown, enabled?: unknown, matchers: unknown, name?: unknown, owner_worker_tag?: unknown, priority?: unknown, source?: unknown)
Update routing rule
ArgumentTypeDescription
rule_identifierstring
actionsunknown
enabled?unknown
matchersunknown
name?unknown
owner_worker_tag?unknown
priority?unknown
source?unknown
fn delete_routing_rule(rule_identifier: string)
Delete routing rule
ArgumentTypeDescription
rule_identifierstring
fn get_publiclistsuppressionzonerouting(page?: number, per_page?: number, order?: enum, direction?: enum)
List zone email suppressions
ArgumentTypeDescription
page?number
per_page?number
order?enum
direction?enum
fn create_post_publicnewsuppressionzonerouting(email: string, expires_at?: string)
Create zone email suppression
ArgumentTypeDescription
emailstring
expires_at?string
fn get_publicgetsuppressionzonerouting(suppression_id: string)
Get zone email suppression
ArgumentTypeDescription
suppression_idstring
fn delete_publicdeletesuppressionzonerouting(suppression_id: string)
Delete zone email suppression
ArgumentTypeDescription
suppression_idstring
fn list_sending_subdomains()
List sending subdomains
fn create_sending_subdomain(name: string)
Create a sending subdomain
ArgumentTypeDescription
namestringThe subdomain name. Must be within the zone.
fn create_email_sending_subdomains_preview_sending_subdomain(name: string)
Preview sending subdomain DNS
ArgumentTypeDescription
namestringThe subdomain name. Must be within the zone.
fn get_sending_subdomain(subdomain_id: string)
Get a sending subdomain
ArgumentTypeDescription
subdomain_idstring
fn update_sending_subdomain(subdomain_id: string, preview_enabled: boolean)
Update a sending subdomain
ArgumentTypeDescription
subdomain_idstring
preview_enabledbooleanWhether sent messages from this subdomain can be previewed in the activity log.
fn delete_sending_subdomain(subdomain_id: string)
Delete a sending subdomain
ArgumentTypeDescription
subdomain_idstring
fn get_sending_subdomain_dns(subdomain_id: string)
Get sending subdomain DNS records
ArgumentTypeDescription
subdomain_idstring
fn email_sending_subdomains_fix_sending_subdomain_dns(subdomain_id: string)
Fix sending subdomain DNS records
ArgumentTypeDescription
subdomain_idstring
fn get_sending_subdomain_dns_status(subdomain_id: string)
Get sending subdomain DNS status
ArgumentTypeDescription
subdomain_idstring
fn get_publiclistsuppressionzonesending(page?: number, per_page?: number, order?: enum, direction?: enum)
List zone email suppressions
ArgumentTypeDescription
page?number
per_page?number
order?enum
direction?enum
fn create_post_publicnewsuppressionzonesending(email: string, expires_at?: string)
Create zone email suppression
ArgumentTypeDescription
emailstring
expires_at?string
fn get_publicgetsuppressionzonesending(suppression_id: string)
Get zone email suppression
ArgumentTypeDescription
suppression_idstring
fn delete_publicdeletesuppressionzonesending(suppression_id: string)
Delete zone email suppression
ArgumentTypeDescription
suppression_idstring

Resources

dmarc_reports_status(infinite)— Get DMARC Report Status
configure_dmarc_reports(infinite)— Configure DMARC Reports
inspect_spf(infinite)— Inspect SPF Record
email_routing_settings(infinite)— Get Email Routing settings
email_routing_settings_replace_email_routing_settings(infinite)— Update Email Routing settings
email_routing_settings_email_routing_dns_settings(infinite)— Email Routing - DNS settings
email_routing_settings_enable_email_routing_dns(infinite)— Enable Email Routing
email_routing_settings_unlock_email_routing_dns(infinite)— Unlock Email Routing
routing_rules(infinite)— List routing rules
routing_rule(infinite)— Create routing rule
catch_all_rule(infinite)— Get catch-all rule
get_publiclistsuppressionzonerouting(infinite)— List zone email suppressions
post_publicnewsuppressionzonerouting(infinite)— Create zone email suppression
publicgetsuppressionzonerouting(infinite)— Get zone email suppression
sending_subdomains(infinite)— List sending subdomains
sending_subdomain(infinite)— Create a sending subdomain
email_sending_subdomains_preview_sending_subdomain(infinite)— Preview sending subdomain DNS
get_sending_subdomain_dns(infinite)— Get sending subdomain DNS records
email_sending_subdomains_fix_sending_subdomain_dns(infinite)— Fix sending subdomain DNS records
sending_subdomain_dns_status(infinite)— Get sending subdomain DNS status
get_publiclistsuppressionzonesending(infinite)— List zone email suppressions
post_publicnewsuppressionzonesending(infinite)— Create zone email suppression
publicgetsuppressionzonesending(infinite)— Get zone email suppression
04Previous Versions1
2026.07.19.1

2026.07.19.1

Added: Initial code-generated release of @webframp/cloudflare/email-routing with 34 methods covering the Cloudflare email routing API surface.

05Stats
A
100 / 100
Downloads
0
Archive size
16.0 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
06Platforms
07Labels
#cloudflare#email#routing