---
title: Filters
---

[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**

# Filters

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

Deprecated

filters.list(FilterListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[FirewallFilter](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)>)]

GET/zones/{zone\_id}/filters

##### [Get a filter](https://developers.cloudflare.com/api/python/resources/filters/methods/get)

Deprecated

filters.get(strfilter\_id, FilterGetParams\*\*kwargs) -> [FirewallFilter](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)>)

GET/zones/{zone\_id}/filters/{filter\_id}

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

Deprecated

filters.create(FilterCreateParams\*\*kwargs) -> SyncSinglePage\[[FirewallFilter](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)>)]

POST/zones/{zone\_id}/filters

##### [Update a filter](https://developers.cloudflare.com/api/python/resources/filters/methods/update)

Deprecated

filters.update(strfilter\_id, FilterUpdateParams\*\*kwargs) -> [FirewallFilter](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)>)

PUT/zones/{zone\_id}/filters/{filter\_id}

##### [Delete a filter](https://developers.cloudflare.com/api/python/resources/filters/methods/delete)

Deprecated

filters.delete(strfilter\_id, FilterDeleteParams\*\*kwargs) -> [FilterDeleteResponse](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20filter_delete_response%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/filters/{filter\_id}

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

Deprecated

filters.bulk\_update(FilterBulkUpdateParams\*\*kwargs) -> SyncSinglePage\[[FirewallFilter](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)>)]

PUT/zones/{zone\_id}/filters

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

Deprecated

filters.bulk\_delete(FilterBulkDeleteParams\*\*kwargs) -> [FilterBulkDeleteResponse](<https://developers.cloudflare.com/api/python/resources/filters#(resource)%20filters%20%3E%20(model)%20filter_bulk_delete_response%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/filters

##### ModelsExpand Collapse

<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>

[Link to this property](<#(resource)%20filters%20%3E%20(model)%20firewall_filter%20%3E%20(schema)>)

<details>

<summary>

class FilterDeleteResponse: …

</summary>

id: str

The unique identifier of the filter.

maxLength32

minLength32

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

</details>

[Link to this property](<#(resource)%20filters%20%3E%20(model)%20filter_delete_response%20%3E%20(schema)>)

<details>

<summary>

Optional\[List\[FilterBulkDeleteResponseItem]]

</summary>

id: Optional\[str]

The unique identifier of the filter.

maxLength32

minLength32

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

</details>

[Link to this property](<#(resource)%20filters%20%3E%20(model)%20filter_bulk_delete_response%20%3E%20(schema)>)