Search + K

Command Palette

Search for a command to run...

Sign In

Create firewall rules

Deprecated
POST /zones/{zone_id}/firewall/rules
Copy endpoint
https://api.cloudflare.com/client/v4

Create one or more firewall rules.

Parameters

path Path Parameters

Name Type
zone_id required
type FirewallIdentifier = string

Request Body

application/json required
{ action: FirewallAction

The action to perform when the threshold of matched traffic within the configured period is exceeded.

interface FirewallAction {
mode?: FirewallMode;
response?: FirewallCustomResponse;
timeout?: FirewallTimeout;
}
;filter: FirewallFilter
interface FirewallFilter {
description?: FirewallFiltersComponentsSchemasDescription;
expression?: FirewallExpression;
id?: FirewallFiltersComponentsSchemasId;
paused?: FirewallFiltersComponentsSchemasPaused;
ref?: FirewallSchemasRef;
}
; }

Responses

200 application/json

Create firewall rules response

type FirewallFilterRulesResponseCollection = type FirewallApiResponseCollection = never & { result: FirewallFilterRuleResponse
type FirewallFilterRuleResponse = never
[]
; }

Client Errors

4XX application/json

Create firewall rules response failure

type FirewallFilterRulesResponseCollection = type FirewallApiResponseCollection = never & { result: FirewallFilterRuleResponse
type FirewallFilterRuleResponse = never
[]
; }
& interface FirewallApiResponseCommonFailure {
errors: FirewallMessages
type FirewallMessages = { code: number;message: string; }[]
;
messages: FirewallMessages
type FirewallMessages = { code: number;message: string; }[]
;
result: null;
success: false;
}