Update a filter

Deprecated

PUT /zones/{zone_id}/filters/{filter_id}

Copy endpoint

https://api.cloudflare.com/client/v4

Updates an existing filter.

Parameters

path Path Parameters

Name	Type
`filter_id` required	type FirewallFiltersComponentsSchemasId = string
`zone_id` required	type FirewallIdentifier = string

Request Body

application/json required

interface FirewallFilter {
description?:

FirewallFiltersComponentsSchemasDescription

An informative summary of the filter.

type FirewallFiltersComponentsSchemasDescription = string

;
expression?:

FirewallExpression

The filter expression. For more information, refer to Expressions.

type FirewallExpression = string

;
id?:

FirewallFiltersComponentsSchemasId

The unique identifier of the filter.

type FirewallFiltersComponentsSchemasId = string

;
paused?:

FirewallFiltersComponentsSchemasPaused

When true, indicates that the filter is currently paused.

type FirewallFiltersComponentsSchemasPaused = boolean

;
ref?:

FirewallSchemasRef

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

type FirewallSchemasRef = string

;
}

Responses

200 application/json

Update a filter response

type FirewallFilterResponseSingle = type FirewallApiResponseSingle = never & { result:

FirewallFilter

interface FirewallFilter {
description?: FirewallFiltersComponentsSchemasDescription;
expression?: FirewallExpression;
id?: FirewallFiltersComponentsSchemasId;
paused?: FirewallFiltersComponentsSchemasPaused;
ref?: FirewallSchemasRef;
}

; }

Client Errors

4XX application/json

Update a filter response failure

type FirewallFilterResponseSingle = type FirewallApiResponseSingle = never & { result:

FirewallFilter

; } & interface FirewallApiResponseCommonFailure {
errors:

FirewallMessages

type FirewallMessages = { code: number;message: string; }[]

;
messages:

FirewallMessages

type FirewallMessages = { code: number;message: string; }[]

;
result: null;
success: false;
}