[ Web Proxy ]
URL:
Viewing: https://developers.cloudflare.com/rules/compression-rules/create-api/ [Back]  [Original]

Create a compression rule via API Cloudflare Rules docsSkip to content
SearchCtrlKLog in
  1. Home
  2. /Rules
  3. /Compression Rules
  4. /Create a rule via API

Create a compression rule via API

Last updated Apr 16, 2026Copy as MarkdownView as MarkdownAgent setup
OverviewBasic rule settingsProcedureExamples

Use the Rulesets API to create a compression rule via API.

Basic rule settings

When creating a compression rule via API, make sure you:

  • Set the rule action to compress_response.
  • Define the parameters in the action_parameters field according to the settings you wish to override for matching requests.
  • Deploy the rule to the http_response_compression phase at the zone level.

Procedure

Follow this workflow to create a compression rule for a given zone via API:

  1. Use the List zone rulesets operation to check if there is already a ruleset for the http_response_compression phase at the zone level.

  2. If the phase ruleset does not exist, create it using the Create a zone ruleset operation. In the new ruleset properties, set the following values:

    • kind: zone
    • phase: http_response_compression
  3. Use the Update a zone ruleset operation to add a compression rule to the list of ruleset rules. Alternatively, include the rule in the Create a zone ruleset request mentioned in the previous step.

Examples

For example API requests, refer to the Examples gallery.

PreviousCreate a rule in the dashboardNextAvailable settings

Was this helpful?

YesNo
Edit pageReport issue
[]

Web Proxy Viewer  |  New URL  |  Original Page