Create filters

Deprecated

POST /zones/{zone_id}/filters

Copy endpoint

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

Creates one or more filters.

Parameters

path Path Parameters

Name	Type
`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

Create filters response

type FirewallFilterResponseCollection = type FirewallApiResponseCollection = never & { result?:

FirewallFilter

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

[]; }

Client Errors

4XX application/json

Create filters response failure

type FirewallFilterResponseCollection = type FirewallApiResponseCollection = 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;
}