--- title: Rules --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Rules ##### [List account or zone routing rules](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/list) email\_routing.rules.list(RuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AccountRule]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/email/routing/rules ##### [Get routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/get) email\_routing.rules.get(strrule\_identifier, RuleGetParams\*\*kwargs) -> [EmailRoutingRule]() GET/zones/{zone\_id}/email/routing/rules/{rule\_identifier} ##### [Create routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/create) email\_routing.rules.create(RuleCreateParams\*\*kwargs) -> [EmailRoutingRule]() POST/zones/{zone\_id}/email/routing/rules ##### [Update routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/update) email\_routing.rules.update(strrule\_identifier, RuleUpdateParams\*\*kwargs) -> [EmailRoutingRule]() PUT/zones/{zone\_id}/email/routing/rules/{rule\_identifier} ##### [Delete routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/delete) email\_routing.rules.delete(strrule\_identifier, RuleDeleteParams\*\*kwargs) -> [EmailRoutingRule]() DELETE/zones/{zone\_id}/email/routing/rules/{rule\_identifier} ##### ModelsExpand Collapse
class Action: … Actions pattern.
type: Literal\["drop", "forward", "worker"] Type of supported action. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(model)%20action%20%3E%20(schema)>)
class EmailRoutingRule: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[Action]] List actions patterns.
type: Literal\["drop", "forward", "worker"] Type of supported action. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[Matcher]] Matching patterns to forward to your actions.
type: Literal\["all", "literal"] Type of matcher. One of the following: "all" Link to this property "literal" Link to this property
Link to this property field: Optional\[Literal\["to"]] Field for type matcher. Link to this property value: Optional\[str] Value for matcher. maxLength90 Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property priority: Optional\[float] Priority of the routing rule. minimum0 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(model)%20email_routing_rule%20%3E%20(schema)>)
class Matcher: … Matching pattern to forward your actions.
type: Literal\["all", "literal"] Type of matcher. One of the following: "all" Link to this property "literal" Link to this property
Link to this property field: Optional\[Literal\["to"]] Field for type matcher. Link to this property value: Optional\[str] Value for matcher. maxLength90 Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(model)%20matcher%20%3E%20(schema)>) #### RulesCatch Alls ##### [Get catch-all rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/subresources/catch_alls/methods/get) email\_routing.rules.catch\_alls.get(CatchAllGetParams\*\*kwargs) -> [CatchAllGetResponse]() GET/zones/{zone\_id}/email/routing/rules/catch\_all ##### [Update catch-all rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/subresources/catch_alls/methods/update) email\_routing.rules.catch\_alls.update(CatchAllUpdateParams\*\*kwargs) -> [CatchAllUpdateResponse]() PUT/zones/{zone\_id}/email/routing/rules/catch\_all ##### ModelsExpand Collapse
class CatchAllAction: … Action for the catch-all routing rule.
type: Literal\["drop", "forward", "worker"] Type of action for catch-all rule. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_action%20%3E%20(schema)>)
class CatchAllMatcher: … Matcher for catch-all routing rule. type: Literal\["all"] Type of matcher. Default is ‘all’. Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_matcher%20%3E%20(schema)>)
class CatchAllGetResponse: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[CatchAllAction]] List actions for the catch-all routing rule.
type: Literal\["drop", "forward", "worker"] Type of action for catch-all rule. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[CatchAllMatcher]] List of matchers for the catch-all routing rule. type: Literal\["all"] Type of matcher. Default is ‘all’. Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_get_response%20%3E%20(schema)>)
class CatchAllUpdateResponse: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[CatchAllAction]] List actions for the catch-all routing rule.
type: Literal\["drop", "forward", "worker"] Type of action for catch-all rule. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[CatchAllMatcher]] List of matchers for the catch-all routing rule. type: Literal\["all"] Type of matcher. Default is ‘all’. Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_update_response%20%3E%20(schema)>)