---
title: Firewall
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Firewall

#### FirewallLockdowns

##### [List Zone Lockdown rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/lockdowns/methods/list)

firewall.lockdowns.list(LockdownListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Lockdown](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)>)]

GET/zones/{zone\_id}/firewall/lockdowns

##### [Get a Zone Lockdown rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/lockdowns/methods/get)

firewall.lockdowns.get(strlock\_downs\_id, LockdownGetParams\*\*kwargs) -> [Lockdown](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)>)

GET/zones/{zone\_id}/firewall/lockdowns/{lock\_downs\_id}

##### [Create a Zone Lockdown rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/lockdowns/methods/create)

firewall.lockdowns.create(LockdownCreateParams\*\*kwargs) -> [Lockdown](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)>)

POST/zones/{zone\_id}/firewall/lockdowns

##### [Update a Zone Lockdown rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/lockdowns/methods/update)

firewall.lockdowns.update(strlock\_downs\_id, LockdownUpdateParams\*\*kwargs) -> [Lockdown](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)>)

PUT/zones/{zone\_id}/firewall/lockdowns/{lock\_downs\_id}

##### [Delete a Zone Lockdown rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/lockdowns/methods/delete)

firewall.lockdowns.delete(strlock\_downs\_id, LockdownDeleteParams\*\*kwargs) -> [LockdownDeleteResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_delete_response%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/firewall/lockdowns/{lock\_downs\_id}

##### ModelsExpand Collapse

<details>

<summary>

List\[ConfigurationItem]

A list of IP addresses or CIDR ranges that will be allowed to access the URLs specified in the Zone Lockdown rule. You can include any number of <code>ip</code> or <code>ip_range</code> configurations.

</summary>

One of the following:

<details>

<summary>

class LockdownIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the Zone Lockdown rule.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_ip_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class LockdownCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the Zone Lockdown rule.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code>.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_cidr_configuration%20%3E%20(schema)">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.lockdowns%20%3E%20(model)%20configuration%20%3E%20(schema)>)

<details>

<summary>

class Lockdown: …

</summary>

id: str

The unique identifier of the Zone Lockdown rule.

maxLength32

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

configurations: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20configuration%20%3E%20(schema)">Configuration</a>

A list of IP addresses or CIDR ranges that will be allowed to access the URLs specified in the Zone Lockdown rule. You can include any number of <code>ip</code> or <code>ip_range</code> configurations.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20configurations">Link to this property</a>

created\_on: datetime

The timestamp of when the rule was created.

formatdate-time

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20created_on">Link to this property</a>

description: str

An informative summary of the rule.

maxLength1024

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

modified\_on: datetime

The timestamp of when the rule was last modified.

formatdate-time

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20modified_on">Link to this property</a>

paused: bool

When true, indicates that the rule is currently paused.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

urls: List\[<a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_url%20%3E%20(schema)">LockdownURL</a>]

The URLs to include in the rule definition. You can use wildcards. Each entered URL will be escaped before use, which means you can only use simple wildcard patterns.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)%20%3E%20(property)%20urls">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown%20%3E%20(schema)>)

<details>

<summary>

class LockdownCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the Zone Lockdown rule.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code>.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_cidr_configuration%20%3E%20(schema)>)

<details>

<summary>

class LockdownIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the Zone Lockdown rule.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_ip_configuration%20%3E%20(schema)>)

str

[Link to this property](<#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_url%20%3E%20(schema)>)

<details>

<summary>

class LockdownDeleteResponse: …

</summary>

id: Optional\[str]

The unique identifier of the Zone Lockdown rule.

maxLength32

<a href="#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_delete_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.lockdowns%20%3E%20(model)%20lockdown_delete_response%20%3E%20(schema)>)

#### FirewallRules

##### [List firewall rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/list)

Deprecated

firewall.rules.list(RuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)]

GET/zones/{zone\_id}/firewall/rules

##### [Get a firewall rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/get)

Deprecated

firewall.rules.get(strrule\_id, RuleGetParams\*\*kwargs) -> [FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)

GET/zones/{zone\_id}/firewall/rules/{rule\_id}

##### [Create firewall rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/create)

Deprecated

firewall.rules.create(RuleCreateParams\*\*kwargs) -> SyncSinglePage\[[FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)]

POST/zones/{zone\_id}/firewall/rules

##### [Update a firewall rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/update)

Deprecated

firewall.rules.update(strrule\_id, RuleUpdateParams\*\*kwargs) -> [FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)

PUT/zones/{zone\_id}/firewall/rules/{rule\_id}

##### [Update priority of a firewall rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/edit)

Deprecated

firewall.rules.edit(strrule\_id, RuleEditParams\*\*kwargs) -> SyncSinglePage\[[FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)]

PATCH/zones/{zone\_id}/firewall/rules/{rule\_id}

##### [Delete a firewall rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/delete)

Deprecated

firewall.rules.delete(strrule\_id, RuleDeleteParams\*\*kwargs) -> [FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/firewall/rules/{rule\_id}

##### [Update firewall rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/bulk_update)

Deprecated

firewall.rules.bulk\_update(RuleBulkUpdateParams\*\*kwargs) -> SyncSinglePage\[[FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)]

PUT/zones/{zone\_id}/firewall/rules

##### [Update priority of firewall rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/bulk_edit)

Deprecated

firewall.rules.bulk\_edit(RuleBulkEditParams\*\*kwargs) -> SyncSinglePage\[[FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)]

PATCH/zones/{zone\_id}/firewall/rules

##### [Delete firewall rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/rules/methods/bulk_delete)

Deprecated

firewall.rules.bulk\_delete(RuleBulkDeleteParams\*\*kwargs) -> SyncSinglePage\[[FirewallRule](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)]

DELETE/zones/{zone\_id}/firewall/rules

##### ModelsExpand Collapse

<details>

<summary>

class DeletedFilter: …

</summary>

id: str

The unique identifier of the filter.

maxLength32

minLength32

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20deleted_filter%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

deleted: bool

When true, indicates that the firewall rule was deleted.

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20deleted_filter%20%3E%20(schema)%20%3E%20(property)%20deleted">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.rules%20%3E%20(model)%20deleted_filter%20%3E%20(schema)>)

<details>

<summary>

class FirewallRule: …

</summary>

id: Optional\[str]

The unique identifier of the firewall rule.

maxLength32

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

action: Optional\[Action]

The action to apply to a matched request. The <code>log</code> action is only available on an Enterprise plan.

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20action">Link to this property</a>

description: Optional\[str]

An informative summary of the firewall rule.

maxLength500

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

filter: Optional\[Filter]

</summary>

One of the following:

<details>

<summary>

class FirewallFilter: …

</summary>

id: Optional\[str]

The unique identifier of the filter.

maxLength32

minLength32

<a href="#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

description: Optional\[str]

An informative summary of the filter.

maxLength500

<a href="#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

expression: Optional\[str]

The filter expression. For more information, refer to <a href="https://developers.cloudflare.com/ruleset-engine/rules-language/expressions/">Expressions</a>.

<a href="#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)%20%3E%20(property)%20expression">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the filter is currently paused.

<a href="#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

ref: Optional\[str]

A short reference tag. Allows you to select related filters.

maxLength50

<a href="#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)%20%3E%20(property)%20ref">Link to this property</a>

</details>

<a href="#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class DeletedFilter: …

</summary>

id: str

The unique identifier of the filter.

maxLength32

minLength32

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20deleted_filter%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

deleted: bool

When true, indicates that the firewall rule was deleted.

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20deleted_filter%20%3E%20(schema)%20%3E%20(property)%20deleted">Link to this property</a>

</details>

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20deleted_filter%20%3E%20(schema)">Link to this property</a>

</details>

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20filter">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the firewall rule is currently paused.

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

priority: Optional\[float]

The priority of the rule. Optional value used to define the processing order. A lower number indicates a higher priority. If not provided, rules with a defined priority will be processed before rules without a priority.

maximum2147483647

minimum0

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20priority">Link to this property</a>

<details>

<summary>

products: Optional\[List\[<a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)">Product</a>]]

</summary>

One of the following:

"zoneLockdown"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"uaBlock"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

"bic"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

"hot"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

"securityLevel"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%204">Link to this property</a>

"rateLimit"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%205">Link to this property</a>

"waf"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%206">Link to this property</a>

</details>

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20products">Link to this property</a>

ref: Optional\[str]

A short reference tag. Allows you to select related firewall rules.

maxLength50

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)%20%3E%20(property)%20ref">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.rules%20%3E%20(model)%20firewall_rule%20%3E%20(schema)>)

<details>

<summary>

Literal\["zoneLockdown", "uaBlock", "bic", 4 more]

A list of products to bypass for a request when using the <code>bypass</code> action.

</summary>

One of the following:

"zoneLockdown"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"uaBlock"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

"bic"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

"hot"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

"securityLevel"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%204">Link to this property</a>

"rateLimit"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%205">Link to this property</a>

"waf"

<a href="#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)%20%3E%20(member)%206">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.rules%20%3E%20(model)%20product%20%3E%20(schema)>)

#### FirewallAccess Rules

##### [List IP Access rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/access_rules/methods/list)

firewall.access\_rules.list(AccessRuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AccessRuleListResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)>)]

GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/firewall/access\_rules/rules

##### [Get an IP Access rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/access_rules/methods/get)

firewall.access\_rules.get(strrule\_id, AccessRuleGetParams\*\*kwargs) -> [AccessRuleGetResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)>)

GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/firewall/access\_rules/rules/{rule\_id}

##### [Create an IP Access rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/access_rules/methods/create)

firewall.access\_rules.create(AccessRuleCreateParams\*\*kwargs) -> [AccessRuleCreateResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)>)

POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/firewall/access\_rules/rules

##### [Update an IP Access rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/access_rules/methods/edit)

firewall.access\_rules.edit(strrule\_id, AccessRuleEditParams\*\*kwargs) -> [AccessRuleEditResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)>)

PATCH/{accounts\_or\_zones}/{account\_or\_zone\_id}/firewall/access\_rules/rules/{rule\_id}

##### [Delete an IP Access rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/access_rules/methods/delete)

firewall.access\_rules.delete(strrule\_id, AccessRuleDeleteParams\*\*kwargs) -> [AccessRuleDeleteResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_delete_response%20%3E%20(schema)>)

DELETE/{accounts\_or\_zones}/{account\_or\_zone\_id}/firewall/access\_rules/rules/{rule\_id}

##### ModelsExpand Collapse

<details>

<summary>

class AccessRuleCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code> for IPv4 ranges, and prefix lengths <code>/32</code>, <code>/48</code>, and <code>/64</code> for IPv6 ranges.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)>)

<details>

<summary>

class AccessRuleIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)>)

<details>

<summary>

class ASNConfiguration: …

</summary>

target: Optional\[Literal\["asn"]]

The configuration target. You must set the target to <code>asn</code> when specifying an Autonomous System Number (ASN) in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The AS number to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)>)

<details>

<summary>

class CountryConfiguration: …

</summary>

target: Optional\[Literal\["country"]]

The configuration target. You must set the target to <code>country</code> when specifying a country code in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The two-letter ISO-3166-1 alpha-2 code to match. For more information, refer to <a href="https://developers.cloudflare.com/waf/tools/ip-access-rules/parameters/#country">IP Access rules: Parameters</a>.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)>)

<details>

<summary>

class IPV6Configuration: …

</summary>

target: Optional\[Literal\["ip6"]]

The configuration target. You must set the target to <code>ip6</code> when specifying an IPv6 address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IPv6 address to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)>)

<details>

<summary>

class AccessRuleListResponse: …

</summary>

id: str

The unique identifier of the IP Access rule.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["block", "challenge", "whitelist", 2 more]]

The available actions that a rule can apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes">Link to this property</a>

<details>

<summary>

configuration: Configuration

The rule configuration.

</summary>

One of the following:

<details>

<summary>

class AccessRuleIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class IPV6Configuration: …

</summary>

target: Optional\[Literal\["ip6"]]

The configuration target. You must set the target to <code>ip6</code> when specifying an IPv6 address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IPv6 address to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class AccessRuleCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code> for IPv4 ranges, and prefix lengths <code>/32</code>, <code>/48</code>, and <code>/64</code> for IPv6 ranges.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class ASNConfiguration: …

</summary>

target: Optional\[Literal\["asn"]]

The configuration target. You must set the target to <code>asn</code> when specifying an Autonomous System Number (ASN) in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The AS number to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class CountryConfiguration: …

</summary>

target: Optional\[Literal\["country"]]

The configuration target. You must set the target to <code>country</code> when specifying a country code in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The two-letter ISO-3166-1 alpha-2 code to match. For more information, refer to <a href="https://developers.cloudflare.com/waf/tools/ip-access-rules/parameters/#country">IP Access rules: Parameters</a>.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

<details>

<summary>

mode: Literal\["block", "challenge", "whitelist", 2 more]

The action to apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

created\_on: Optional\[datetime]

The timestamp of when the rule was created.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20created_on">Link to this property</a>

modified\_on: Optional\[datetime]

The timestamp of when the rule was last modified.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20modified_on">Link to this property</a>

notes: Optional\[str]

An informative summary of the rule, typically used as a reminder or explanation.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20notes">Link to this property</a>

<details>

<summary>

scope: Optional\[Scope]

All zones owned by the user will have the rule applied.

</summary>

id: Optional\[str]

Defines an identifier.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20id">Link to this property</a>

email: Optional\[str]

The contact email address of the user.

maxLength90

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20email">Link to this property</a>

<details>

<summary>

type: Optional\[Literal\["user", "organization"]]

Defines the scope of the rule.

</summary>

One of the following:

"user"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

"organization"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20scope">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_list_response%20%3E%20(schema)>)

<details>

<summary>

class AccessRuleGetResponse: …

</summary>

id: str

The unique identifier of the IP Access rule.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["block", "challenge", "whitelist", 2 more]]

The available actions that a rule can apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes">Link to this property</a>

<details>

<summary>

configuration: Configuration

The rule configuration.

</summary>

One of the following:

<details>

<summary>

class AccessRuleIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class IPV6Configuration: …

</summary>

target: Optional\[Literal\["ip6"]]

The configuration target. You must set the target to <code>ip6</code> when specifying an IPv6 address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IPv6 address to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class AccessRuleCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code> for IPv4 ranges, and prefix lengths <code>/32</code>, <code>/48</code>, and <code>/64</code> for IPv6 ranges.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class ASNConfiguration: …

</summary>

target: Optional\[Literal\["asn"]]

The configuration target. You must set the target to <code>asn</code> when specifying an Autonomous System Number (ASN) in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The AS number to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class CountryConfiguration: …

</summary>

target: Optional\[Literal\["country"]]

The configuration target. You must set the target to <code>country</code> when specifying a country code in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The two-letter ISO-3166-1 alpha-2 code to match. For more information, refer to <a href="https://developers.cloudflare.com/waf/tools/ip-access-rules/parameters/#country">IP Access rules: Parameters</a>.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

<details>

<summary>

mode: Literal\["block", "challenge", "whitelist", 2 more]

The action to apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

created\_on: Optional\[datetime]

The timestamp of when the rule was created.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20created_on">Link to this property</a>

modified\_on: Optional\[datetime]

The timestamp of when the rule was last modified.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20modified_on">Link to this property</a>

notes: Optional\[str]

An informative summary of the rule, typically used as a reminder or explanation.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20notes">Link to this property</a>

<details>

<summary>

scope: Optional\[Scope]

All zones owned by the user will have the rule applied.

</summary>

id: Optional\[str]

Defines an identifier.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20id">Link to this property</a>

email: Optional\[str]

The contact email address of the user.

maxLength90

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20email">Link to this property</a>

<details>

<summary>

type: Optional\[Literal\["user", "organization"]]

Defines the scope of the rule.

</summary>

One of the following:

"user"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

"organization"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20scope">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_get_response%20%3E%20(schema)>)

<details>

<summary>

class AccessRuleCreateResponse: …

</summary>

id: str

The unique identifier of the IP Access rule.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["block", "challenge", "whitelist", 2 more]]

The available actions that a rule can apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes">Link to this property</a>

<details>

<summary>

configuration: Configuration

The rule configuration.

</summary>

One of the following:

<details>

<summary>

class AccessRuleIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class IPV6Configuration: …

</summary>

target: Optional\[Literal\["ip6"]]

The configuration target. You must set the target to <code>ip6</code> when specifying an IPv6 address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IPv6 address to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class AccessRuleCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code> for IPv4 ranges, and prefix lengths <code>/32</code>, <code>/48</code>, and <code>/64</code> for IPv6 ranges.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class ASNConfiguration: …

</summary>

target: Optional\[Literal\["asn"]]

The configuration target. You must set the target to <code>asn</code> when specifying an Autonomous System Number (ASN) in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The AS number to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class CountryConfiguration: …

</summary>

target: Optional\[Literal\["country"]]

The configuration target. You must set the target to <code>country</code> when specifying a country code in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The two-letter ISO-3166-1 alpha-2 code to match. For more information, refer to <a href="https://developers.cloudflare.com/waf/tools/ip-access-rules/parameters/#country">IP Access rules: Parameters</a>.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

<details>

<summary>

mode: Literal\["block", "challenge", "whitelist", 2 more]

The action to apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

created\_on: Optional\[datetime]

The timestamp of when the rule was created.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20created_on">Link to this property</a>

modified\_on: Optional\[datetime]

The timestamp of when the rule was last modified.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20modified_on">Link to this property</a>

notes: Optional\[str]

An informative summary of the rule, typically used as a reminder or explanation.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20notes">Link to this property</a>

<details>

<summary>

scope: Optional\[Scope]

All zones owned by the user will have the rule applied.

</summary>

id: Optional\[str]

Defines an identifier.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20id">Link to this property</a>

email: Optional\[str]

The contact email address of the user.

maxLength90

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20email">Link to this property</a>

<details>

<summary>

type: Optional\[Literal\["user", "organization"]]

Defines the scope of the rule.

</summary>

One of the following:

"user"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

"organization"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20scope">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_create_response%20%3E%20(schema)>)

<details>

<summary>

class AccessRuleEditResponse: …

</summary>

id: str

The unique identifier of the IP Access rule.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["block", "challenge", "whitelist", 2 more]]

The available actions that a rule can apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20allowed_modes">Link to this property</a>

<details>

<summary>

configuration: Configuration

The rule configuration.

</summary>

One of the following:

<details>

<summary>

class AccessRuleIPConfiguration: …

</summary>

target: Optional\[Literal\["ip"]]

The configuration target. You must set the target to <code>ip</code> when specifying an IP address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address to match. This address will be compared to the IP address of incoming requests.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_ip_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class IPV6Configuration: …

</summary>

target: Optional\[Literal\["ip6"]]

The configuration target. You must set the target to <code>ip6</code> when specifying an IPv6 address in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IPv6 address to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20ipv6_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class AccessRuleCIDRConfiguration: …

</summary>

target: Optional\[Literal\["ip\_range"]]

The configuration target. You must set the target to <code>ip_range</code> when specifying an IP address range in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The IP address range to match. You can only use prefix lengths <code>/16</code> and <code>/24</code> for IPv4 ranges, and prefix lengths <code>/32</code>, <code>/48</code>, and <code>/64</code> for IPv6 ranges.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_cidr_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class ASNConfiguration: …

</summary>

target: Optional\[Literal\["asn"]]

The configuration target. You must set the target to <code>asn</code> when specifying an Autonomous System Number (ASN) in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The AS number to match.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20asn_configuration%20%3E%20(schema)">Link to this property</a>

<details>

<summary>

class CountryConfiguration: …

</summary>

target: Optional\[Literal\["country"]]

The configuration target. You must set the target to <code>country</code> when specifying a country code in the rule.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The two-letter ISO-3166-1 alpha-2 code to match. For more information, refer to <a href="https://developers.cloudflare.com/waf/tools/ip-access-rules/parameters/#country">IP Access rules: Parameters</a>.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20country_configuration%20%3E%20(schema)">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

<details>

<summary>

mode: Literal\["block", "challenge", "whitelist", 2 more]

The action to apply to a matched request.

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"whitelist"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

created\_on: Optional\[datetime]

The timestamp of when the rule was created.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20created_on">Link to this property</a>

modified\_on: Optional\[datetime]

The timestamp of when the rule was last modified.

formatdate-time

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20modified_on">Link to this property</a>

notes: Optional\[str]

An informative summary of the rule, typically used as a reminder or explanation.

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20notes">Link to this property</a>

<details>

<summary>

scope: Optional\[Scope]

All zones owned by the user will have the rule applied.

</summary>

id: Optional\[str]

Defines an identifier.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20id">Link to this property</a>

email: Optional\[str]

The contact email address of the user.

maxLength90

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20email">Link to this property</a>

<details>

<summary>

type: Optional\[Literal\["user", "organization"]]

Defines the scope of the rule.

</summary>

One of the following:

"user"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

"organization"

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20scope%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)%20%3E%20(property)%20scope">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_edit_response%20%3E%20(schema)>)

<details>

<summary>

class AccessRuleDeleteResponse: …

</summary>

id: str

Defines an identifier.

maxLength32

<a href="#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.access_rules%20%3E%20(model)%20access_rule_delete_response%20%3E%20(schema)>)

#### FirewallUA Rules

##### [List User Agent Blocking rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/ua_rules/methods/list)

firewall.ua\_rules.list(UARuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[UARuleListResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)>)]

GET/zones/{zone\_id}/firewall/ua\_rules

##### [Get a User Agent Blocking rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/ua_rules/methods/get)

firewall.ua\_rules.get(strua\_rule\_id, UARuleGetParams\*\*kwargs) -> [UARuleGetResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)>)

GET/zones/{zone\_id}/firewall/ua\_rules/{ua\_rule\_id}

##### [Create a User Agent Blocking rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/ua_rules/methods/create)

firewall.ua\_rules.create(UARuleCreateParams\*\*kwargs) -> [UARuleCreateResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)>)

POST/zones/{zone\_id}/firewall/ua\_rules

##### [Update a User Agent Blocking rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/ua_rules/methods/update)

firewall.ua\_rules.update(strua\_rule\_id, UARuleUpdateParams\*\*kwargs) -> [UARuleUpdateResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)>)

PUT/zones/{zone\_id}/firewall/ua\_rules/{ua\_rule\_id}

##### [Delete a User Agent Blocking rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/ua_rules/methods/delete)

firewall.ua\_rules.delete(strua\_rule\_id, UARuleDeleteParams\*\*kwargs) -> [UARuleDeleteResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/firewall/ua\_rules/{ua\_rule\_id}

##### ModelsExpand Collapse

<details>

<summary>

class UARuleListResponse: …

</summary>

id: Optional\[str]

The unique identifier of the User Agent Blocking rule.

maxLength32

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

configuration: Optional\[Configuration]

The configuration object for the current rule.

</summary>

target: Optional\[str]

The configuration target for this rule. You must set the target to <code>ua</code> for User Agent Blocking rules.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The exact user agent string to match. This value will be compared to the received <code>User-Agent</code> HTTP header value.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

description: Optional\[str]

An informative summary of the rule.

maxLength1024

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

mode: Optional\[Literal\["block", "challenge", "js\_challenge", "managed\_challenge"]]

The action to apply to a matched request.

maxLength12

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the rule is currently paused.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_list_response%20%3E%20(schema)>)

<details>

<summary>

class UARuleGetResponse: …

</summary>

id: Optional\[str]

The unique identifier of the User Agent Blocking rule.

maxLength32

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

configuration: Optional\[Configuration]

The configuration object for the current rule.

</summary>

target: Optional\[str]

The configuration target for this rule. You must set the target to <code>ua</code> for User Agent Blocking rules.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The exact user agent string to match. This value will be compared to the received <code>User-Agent</code> HTTP header value.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

description: Optional\[str]

An informative summary of the rule.

maxLength1024

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

mode: Optional\[Literal\["block", "challenge", "js\_challenge", "managed\_challenge"]]

The action to apply to a matched request.

maxLength12

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the rule is currently paused.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_get_response%20%3E%20(schema)>)

<details>

<summary>

class UARuleCreateResponse: …

</summary>

id: Optional\[str]

The unique identifier of the User Agent Blocking rule.

maxLength32

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

configuration: Optional\[Configuration]

The configuration object for the current rule.

</summary>

target: Optional\[str]

The configuration target for this rule. You must set the target to <code>ua</code> for User Agent Blocking rules.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The exact user agent string to match. This value will be compared to the received <code>User-Agent</code> HTTP header value.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

description: Optional\[str]

An informative summary of the rule.

maxLength1024

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

mode: Optional\[Literal\["block", "challenge", "js\_challenge", "managed\_challenge"]]

The action to apply to a matched request.

maxLength12

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the rule is currently paused.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_create_response%20%3E%20(schema)>)

<details>

<summary>

class UARuleUpdateResponse: …

</summary>

id: Optional\[str]

The unique identifier of the User Agent Blocking rule.

maxLength32

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

configuration: Optional\[Configuration]

The configuration object for the current rule.

</summary>

target: Optional\[str]

The configuration target for this rule. You must set the target to <code>ua</code> for User Agent Blocking rules.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The exact user agent string to match. This value will be compared to the received <code>User-Agent</code> HTTP header value.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

description: Optional\[str]

An informative summary of the rule.

maxLength1024

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

mode: Optional\[Literal\["block", "challenge", "js\_challenge", "managed\_challenge"]]

The action to apply to a matched request.

maxLength12

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the rule is currently paused.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_update_response%20%3E%20(schema)>)

<details>

<summary>

class UARuleDeleteResponse: …

</summary>

id: Optional\[str]

The unique identifier of the User Agent Blocking rule.

maxLength32

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

configuration: Optional\[Configuration]

The configuration object for the current rule.

</summary>

target: Optional\[str]

The configuration target for this rule. You must set the target to <code>ua</code> for User Agent Blocking rules.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20target">Link to this property</a>

value: Optional\[str]

The exact user agent string to match. This value will be compared to the received <code>User-Agent</code> HTTP header value.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20configuration%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20configuration">Link to this property</a>

description: Optional\[str]

An informative summary of the rule.

maxLength1024

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

mode: Optional\[Literal\["block", "challenge", "js\_challenge", "managed\_challenge"]]

The action to apply to a matched request.

maxLength12

</summary>

One of the following:

"block"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"js\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"managed\_challenge"

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

paused: Optional\[bool]

When true, indicates that the rule is currently paused.

<a href="#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)%20%3E%20(property)%20paused">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.ua_rules%20%3E%20(model)%20ua_rule_delete_response%20%3E%20(schema)>)

#### FirewallWAF

#### FirewallWAFOverrides

##### [List WAF overrides](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/overrides/methods/list)

Deprecated

firewall.waf.overrides.list(OverrideListParams\*\*kwargs)

GET/zones/{zone\_id}/firewall/waf/overrides

##### [Get a WAF override](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/overrides/methods/get)

Deprecated

firewall.waf.overrides.get(stroverrides\_id, OverrideGetParams\*\*kwargs)

GET/zones/{zone\_id}/firewall/waf/overrides/{overrides\_id}

##### [Create a WAF override](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/overrides/methods/create)

Deprecated

firewall.waf.overrides.create(OverrideCreateParams\*\*kwargs)

POST/zones/{zone\_id}/firewall/waf/overrides

##### [Update WAF override](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/overrides/methods/update)

Deprecated

firewall.waf.overrides.update(stroverrides\_id, OverrideUpdateParams\*\*kwargs)

PUT/zones/{zone\_id}/firewall/waf/overrides/{overrides\_id}

##### [Delete a WAF override](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/overrides/methods/delete)

Deprecated

firewall.waf.overrides.delete(stroverrides\_id, OverrideDeleteParams\*\*kwargs)

DELETE/zones/{zone\_id}/firewall/waf/overrides/{overrides\_id}

##### ModelsExpand Collapse

str

[Link to this property](<#(resource)%20firewall.waf.overrides%20%3E%20(model)%20override_url%20%3E%20(schema)>)

<details>

<summary>

class RewriteAction: …

Specifies that, when a WAF rule matches, its configured action will be replaced by the action configured in this object.

</summary>

<details>

<summary>

block: Optional\[Literal\["challenge", "block", "simulate", 2 more]]

The WAF rule action to apply.

</summary>

One of the following:

"challenge"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20block%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20block%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20block%20%3E%20(member)%202">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20block%20%3E%20(member)%203">Link to this property</a>

"default"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20block%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20block">Link to this property</a>

<details>

<summary>

challenge: Optional\[Literal\["challenge", "block", "simulate", 2 more]]

The WAF rule action to apply.

</summary>

One of the following:

"challenge"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20challenge%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20challenge%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20challenge%20%3E%20(member)%202">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20challenge%20%3E%20(member)%203">Link to this property</a>

"default"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20challenge%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20challenge">Link to this property</a>

<details>

<summary>

default: Optional\[Literal\["challenge", "block", "simulate", 2 more]]

The WAF rule action to apply.

</summary>

One of the following:

"challenge"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20default%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20default%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20default%20%3E%20(member)%202">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20default%20%3E%20(member)%203">Link to this property</a>

"default"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20default%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20default">Link to this property</a>

<details>

<summary>

disable: Optional\[Literal\["challenge", "block", "simulate", 2 more]]

The WAF rule action to apply.

</summary>

One of the following:

"challenge"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20disable%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20disable%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20disable%20%3E%20(member)%202">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20disable%20%3E%20(member)%203">Link to this property</a>

"default"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20disable%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20disable">Link to this property</a>

<details>

<summary>

simulate: Optional\[Literal\["challenge", "block", "simulate", 2 more]]

The WAF rule action to apply.

</summary>

One of the following:

"challenge"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20simulate%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20simulate%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20simulate%20%3E%20(member)%202">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20simulate%20%3E%20(member)%203">Link to this property</a>

"default"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20simulate%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)%20%3E%20(property)%20simulate">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.overrides%20%3E%20(model)%20rewrite_action%20%3E%20(schema)>)

<details>

<summary>

Dict\[str, Literal\["challenge", "block", "simulate", 2 more]]

An object that allows you to override the action of specific WAF rules. Each key of this object must be the ID of a WAF rule, and each value must be a valid WAF action. Unless you are disabling a rule, ensure that you also enable the rule group that this WAF rule belongs to. When creating a new URI-based WAF override, you must provide a <code>groups</code> object or a <code>rules</code> object.

</summary>

One of the following:

"challenge"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20waf_rule%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20waf_rule%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20waf_rule%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20waf_rule%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"default"

<a href="#(resource)%20firewall.waf.overrides%20%3E%20(model)%20waf_rule%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.overrides%20%3E%20(model)%20waf_rule%20%3E%20(schema)>)

#### FirewallWAFPackages

##### [List WAF packages](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/methods/list)

Deprecated

firewall.waf.packages.list(PackageListParams\*\*kwargs) -> SyncV4PagePaginationArray\[object]

GET/zones/{zone\_id}/firewall/waf/packages

##### [Get a WAF package](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/methods/get)

Deprecated

firewall.waf.packages.get(strpackage\_id, PackageGetParams\*\*kwargs) -> [PackageGetResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages%20%3E%20(model)%20package_get_response%20%3E%20(schema)>)

GET/zones/{zone\_id}/firewall/waf/packages/{package\_id}

##### ModelsExpand Collapse

<details>

<summary>

Union\[Optional\[str], Optional\[object]]

</summary>

One of the following:

Optional\[str]

<a href="#(resource)%20firewall.waf.packages%20%3E%20(model)%20package_get_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

Optional\[object]

<a href="#(resource)%20firewall.waf.packages%20%3E%20(model)%20package_get_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages%20%3E%20(model)%20package_get_response%20%3E%20(schema)>)

#### FirewallWAFPackagesGroups

##### [List WAF rule groups](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/subresources/groups/methods/list)

Deprecated

firewall.waf.packages.groups.list(strpackage\_id, GroupListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Group](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)>)]

GET/zones/{zone\_id}/firewall/waf/packages/{package\_id}/groups

##### [Get a WAF rule group](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/subresources/groups/methods/get)

Deprecated

firewall.waf.packages.groups.get(strgroup\_id, GroupGetParams\*\*kwargs) -> [GroupGetResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_get_response%20%3E%20(schema)>)

GET/zones/{zone\_id}/firewall/waf/packages/{package\_id}/groups/{group\_id}

##### [Update a WAF rule group](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/subresources/groups/methods/edit)

Deprecated

firewall.waf.packages.groups.edit(strgroup\_id, GroupEditParams\*\*kwargs) -> [GroupEditResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_edit_response%20%3E%20(schema)>)

PATCH/zones/{zone\_id}/firewall/waf/packages/{package\_id}/groups/{group\_id}

##### ModelsExpand Collapse

<details>

<summary>

class Group: …

</summary>

id: str

Defines the unique identifier of the rule group.

maxLength32

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

description: Optional\[str]

Defines an informative summary of what the rule group does.

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

<details>

<summary>

mode: Literal\["on", "off"]

Defines the state of the rules contained in the rule group. When <code>on</code>, the rules in the group are configurable/usable.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20mode">Link to this property</a>

name: str

Defines the name of the rule group.

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

rules\_count: float

Defines the number of rules in the current rule group.

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20rules_count">Link to this property</a>

<details>

<summary>

allowed\_modes: Optional\[List\[Literal\["on", "off"]]]

Defines the available states for the rule group.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20allowed_modes">Link to this property</a>

modified\_rules\_count: Optional\[float]

Defines the number of rules within the group that have been modified from their default configuration.

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20modified_rules_count">Link to this property</a>

package\_id: Optional\[str]

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)%20%3E%20(property)%20package_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group%20%3E%20(schema)>)

<details>

<summary>

Union\[Optional\[str], Optional\[object]]

</summary>

One of the following:

Optional\[str]

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_get_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

Optional\[object]

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_get_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_get_response%20%3E%20(schema)>)

<details>

<summary>

Union\[Optional\[str], Optional\[object]]

</summary>

One of the following:

Optional\[str]

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_edit_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

Optional\[object]

<a href="#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_edit_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.groups%20%3E%20(model)%20group_edit_response%20%3E%20(schema)>)

#### FirewallWAFPackagesRules

##### [List WAF rules](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/subresources/rules/methods/list)

Deprecated

firewall.waf.packages.rules.list(strpackage\_id, RuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[RuleListResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)>)]

GET/zones/{zone\_id}/firewall/waf/packages/{package\_id}/rules

##### [Get a WAF rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/subresources/rules/methods/get)

Deprecated

firewall.waf.packages.rules.get(strrule\_id, RuleGetParams\*\*kwargs) -> [RuleGetResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_get_response%20%3E%20(schema)>)

GET/zones/{zone\_id}/firewall/waf/packages/{package\_id}/rules/{rule\_id}

##### [Update a WAF rule](https://developers.cloudflare.com/api/python/resources/firewall/subresources/waf/subresources/packages/subresources/rules/methods/edit)

Deprecated

firewall.waf.packages.rules.edit(strrule\_id, RuleEditParams\*\*kwargs) -> [RuleEditResponse](<https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)>)

PATCH/zones/{zone\_id}/firewall/waf/packages/{package\_id}/rules/{rule\_id}

##### ModelsExpand Collapse

<details>

<summary>

Literal\["on", "off"]

Defines the mode anomaly. When set to <code>on</code>, the current WAF rule will be used when evaluating the request. Applies to anomaly detection WAF rules.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)>)

<details>

<summary>

class WAFRuleGroup: …

Defines the rule group to which the current WAF rule belongs.

</summary>

id: Optional\[str]

Defines the unique identifier of the rule group.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: Optional\[str]

Defines the name of the rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)>)

<details>

<summary>

<a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)">RuleListResponse</a>

When triggered, anomaly detection WAF rules contribute to an overall threat score that will determine if a request is considered malicious. You can configure the total scoring threshold through the ‘sensitivity’ property of the WAF package.

</summary>

One of the following:

<details>

<summary>

class WAFManagedRulesAnomalyRule: …

When triggered, anomaly detection WAF rules contribute to an overall threat score that will determine if a request is considered malicious. You can configure the total scoring threshold through the ‘sensitivity’ property of the WAF package.

</summary>

id: str

Defines the unique identifier of the WAF rule.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[<a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)">AllowedModesAnomaly</a>]

Defines the available modes for the current WAF rule. Applies to anomaly detection WAF rules.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20allowed_modes">Link to this property</a>

description: str

Defines the public description of the WAF rule.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20description">Link to this property</a>

group: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)">WAFRuleGroup</a>

Defines the rule group to which the current WAF rule belongs.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20group">Link to this property</a>

mode: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)">AllowedModesAnomaly</a>

Defines the mode anomaly. When set to <code>on</code>, the current WAF rule will be used when evaluating the request. Applies to anomaly detection WAF rules.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20mode">Link to this property</a>

package\_id: str

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20package_id">Link to this property</a>

priority: str

Defines the order in which the individual WAF rule is executed within its rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20priority">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

<details>

<summary>

class WAFManagedRulesTraditionalDenyRule: …

When triggered, traditional WAF rules cause the firewall to immediately act upon the request based on the configuration of the rule. A ‘deny’ rule will immediately respond to the request based on the configured rule action/mode (for example, ‘block’) and no other rules will be processed.

</summary>

id: str

Defines the unique identifier of the WAF rule.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["default", "disable", "simulate", 2 more]]

Defines the list of possible actions of the WAF rule when it is triggered.

</summary>

One of the following:

"default"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes">Link to this property</a>

<details>

<summary>

default\_mode: Literal\["disable", "simulate", "block", "challenge"]

Defines the default action/mode of a rule.

</summary>

One of the following:

"disable"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%200">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%201">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%202">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode">Link to this property</a>

description: str

Defines the public description of the WAF rule.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20description">Link to this property</a>

group: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)">WAFRuleGroup</a>

Defines the rule group to which the current WAF rule belongs.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20group">Link to this property</a>

<details>

<summary>

mode: Literal\["default", "disable", "simulate", 2 more]

Defines the action that the current WAF rule will perform when triggered. Applies to traditional (deny) WAF rules.

</summary>

One of the following:

"default"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode">Link to this property</a>

package\_id: str

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20package_id">Link to this property</a>

priority: str

Defines the order in which the individual WAF rule is executed within its rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20priority">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

<details>

<summary>

class WAFManagedRulesTraditionalAllowRule: …

When triggered, traditional WAF rules cause the firewall to immediately act on the request based on the rule configuration. An ‘allow’ rule will immediately allow the request and no other rules will be processed.

</summary>

id: str

Defines the unique identifier of the WAF rule.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["on", "off"]]

Defines the available modes for the current WAF rule.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20allowed_modes">Link to this property</a>

description: str

Defines the public description of the WAF rule.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20description">Link to this property</a>

group: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)">WAFRuleGroup</a>

Defines the rule group to which the current WAF rule belongs.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20group">Link to this property</a>

<details>

<summary>

mode: Literal\["on", "off"]

When set to <code>on</code>, the current rule will be used when evaluating the request. Applies to traditional (allow) WAF rules.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20mode">Link to this property</a>

package\_id: str

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20package_id">Link to this property</a>

priority: str

Defines the order in which the individual WAF rule is executed within its rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20priority">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)%20%3E%20(variant)%202">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_list_response%20%3E%20(schema)>)

<details>

<summary>

Union\[Optional\[str], Optional\[object]]

</summary>

One of the following:

Optional\[str]

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_get_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

Optional\[object]

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_get_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_get_response%20%3E%20(schema)>)

<details>

<summary>

<a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)">RuleEditResponse</a>

When triggered, anomaly detection WAF rules contribute to an overall threat score that will determine if a request is considered malicious. You can configure the total scoring threshold through the ‘sensitivity’ property of the WAF package.

</summary>

One of the following:

<details>

<summary>

class WAFManagedRulesAnomalyRule: …

When triggered, anomaly detection WAF rules contribute to an overall threat score that will determine if a request is considered malicious. You can configure the total scoring threshold through the ‘sensitivity’ property of the WAF package.

</summary>

id: str

Defines the unique identifier of the WAF rule.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[<a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)">AllowedModesAnomaly</a>]

Defines the available modes for the current WAF rule. Applies to anomaly detection WAF rules.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20allowed_modes">Link to this property</a>

description: str

Defines the public description of the WAF rule.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20description">Link to this property</a>

group: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)">WAFRuleGroup</a>

Defines the rule group to which the current WAF rule belongs.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20group">Link to this property</a>

mode: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20allowed_modes_anomaly%20%3E%20(schema)">AllowedModesAnomaly</a>

Defines the mode anomaly. When set to <code>on</code>, the current WAF rule will be used when evaluating the request. Applies to anomaly detection WAF rules.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20mode">Link to this property</a>

package\_id: str

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20package_id">Link to this property</a>

priority: str

Defines the order in which the individual WAF rule is executed within its rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(property)%20priority">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

<details>

<summary>

class WAFManagedRulesTraditionalDenyRule: …

When triggered, traditional WAF rules cause the firewall to immediately act upon the request based on the configuration of the rule. A ‘deny’ rule will immediately respond to the request based on the configured rule action/mode (for example, ‘block’) and no other rules will be processed.

</summary>

id: str

Defines the unique identifier of the WAF rule.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["default", "disable", "simulate", 2 more]]

Defines the list of possible actions of the WAF rule when it is triggered.

</summary>

One of the following:

"default"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20allowed_modes">Link to this property</a>

<details>

<summary>

default\_mode: Literal\["disable", "simulate", "block", "challenge"]

Defines the default action/mode of a rule.

</summary>

One of the following:

"disable"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%200">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%201">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%202">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20default_mode">Link to this property</a>

description: str

Defines the public description of the WAF rule.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20description">Link to this property</a>

group: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)">WAFRuleGroup</a>

Defines the rule group to which the current WAF rule belongs.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20group">Link to this property</a>

<details>

<summary>

mode: Literal\["default", "disable", "simulate", 2 more]

Defines the action that the current WAF rule will perform when triggered. Applies to traditional (deny) WAF rules.

</summary>

One of the following:

"default"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"disable"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

"simulate"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%202">Link to this property</a>

"block"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%203">Link to this property</a>

"challenge"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20mode">Link to this property</a>

package\_id: str

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20package_id">Link to this property</a>

priority: str

Defines the order in which the individual WAF rule is executed within its rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20priority">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

<details>

<summary>

class WAFManagedRulesTraditionalAllowRule: …

When triggered, traditional WAF rules cause the firewall to immediately act on the request based on the rule configuration. An ‘allow’ rule will immediately allow the request and no other rules will be processed.

</summary>

id: str

Defines the unique identifier of the WAF rule.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

allowed\_modes: List\[Literal\["on", "off"]]

Defines the available modes for the current WAF rule.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20allowed_modes%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20allowed_modes">Link to this property</a>

description: str

Defines the public description of the WAF rule.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20description">Link to this property</a>

group: <a href="https://developers.cloudflare.com/api/python/resources/firewall#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20waf_rule_group%20%3E%20(schema)">WAFRuleGroup</a>

Defines the rule group to which the current WAF rule belongs.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20group">Link to this property</a>

<details>

<summary>

mode: Literal\["on", "off"]

When set to <code>on</code>, the current rule will be used when evaluating the request. Applies to traditional (allow) WAF rules.

</summary>

One of the following:

"on"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20mode%20%3E%20(member)%200">Link to this property</a>

"off"

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20mode%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20mode">Link to this property</a>

package\_id: str

Defines the unique identifier of a WAF package.

maxLength32

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20package_id">Link to this property</a>

priority: str

Defines the order in which the individual WAF rule is executed within its rule group.

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202%20%3E%20(property)%20priority">Link to this property</a>

</details>

<a href="#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)%20%3E%20(variant)%202">Link to this property</a>

</details>

[Link to this property](<#(resource)%20firewall.waf.packages.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)>)