Skip to content
Cloudflare API
Start here
API Reference
Rate Limits

Create a rate limit

rate_limits.create(RateLimitCreateParams**kwargs)
POST/zones/{zone_id}/rate_limits

Deprecated: This endpoint returns 410 Gone. Please use the Rulesets API instead.

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
Accepted Permissions (at least one required)
Firewall Services Write
ParametersExpand Collapse
zone_id: str

Defines an identifier.

maxLength32
action: Action

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

mode: Optional[Literal["simulate", "ban", "challenge", 2 more]]

The action to perform.

One of the following:
"simulate"
"ban"
"challenge"
"js_challenge"
"managed_challenge"
response: Optional[ActionResponse]

A custom content type and reponse to return when the threshold is exceeded. The custom response configured in this object will override the custom error for the zone. This object is optional. Notes: If you omit this object, Cloudflare will use the default HTML error page. If “mode” is “challenge”, “managed_challenge”, or “js_challenge”, Cloudflare will use the zone challenge pages and you should not provide the “response” object.

body: Optional[str]

The response body to return. The value must conform to the configured content type.

maxLength10240
content_type: Optional[str]

The content type of the body. Must be one of the following: text/plain, text/xml, or application/json.

maxLength50
timeout: Optional[float]

The time in seconds during which Cloudflare will perform the mitigation action. Must be an integer value greater than or equal to the period. Notes: If “mode” is “challenge”, “managed_challenge”, or “js_challenge”, Cloudflare will use the zone’s Challenge Passage time and you should not provide this value.

maximum86400
minimum1
match: Match

Determines which traffic the rate limit counts towards the threshold.

headers: Optional[Iterable[MatchHeader]]
name: Optional[str]

The name of the response header to match.

op: Optional[Literal["eq", "ne"]]

The operator used when matching: eq means “equal” and ne means “not equal”.

One of the following:
"eq"
"ne"
value: Optional[str]

The value of the response header, which must match exactly.

request: Optional[MatchRequest]
methods: Optional[List[Literal["GET", "POST", "PUT", 4 more]]]

The HTTP methods to match. You can specify a subset (for example, ['POST','PUT']) or all methods (['_ALL_']). This field is optional when creating a rate limit.

One of the following:
"GET"
"POST"
"PUT"
"DELETE"
"PATCH"
"HEAD"
"_ALL_"
schemes: Optional[Sequence[str]]

The HTTP schemes to match. You can specify one scheme (['HTTPS']), both schemes (['HTTP','HTTPS']), or all schemes (['_ALL_']). This field is optional.

url: Optional[str]

The URL pattern to match, composed of a host and a path such as example.org/path*. Normalization is applied before the pattern is matched. * wildcards are expanded to match applicable traffic. Query strings are not matched. Set the value to * to match all traffic to your zone.

maxLength1024
response: Optional[MatchResponse]
origin_traffic: Optional[bool]

When true, only the uncached traffic served from your origin servers will count towards rate limiting. In this case, any cached traffic served by Cloudflare will not count towards rate limiting. This field is optional. Notes: This field is deprecated. Instead, use response headers and set “origin_traffic” to “false” to avoid legacy behaviour interacting with the “response_headers” property.

period: float

The time in seconds (an integer value) to count matching traffic. If the count exceeds the configured threshold within this period, Cloudflare will perform the configured action.

maximum86400
minimum10
threshold: float

The threshold that will trigger the configured mitigation action. Configure this value along with the period property to establish a threshold per period.

minimum1

Create a rate limit

import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
client.rate_limits.create(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    action={},
    match={},
    period=900,
    threshold=60,
)
Returns Examples