导航|地址|刷新
Delete a ruleset

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/ruleset-engine/llms.txt
Use this file to discover all available pages before exploring further.

Docs Directory API SDKs Changelog

Search

Log in

Ruleset Engine

/

Overview

About

Overview

Phases

Rulesets

Rules

Basic API operations

View rulesets

Add rules to phase entry point rulesets

Deploy rulesets

Work with managed rulesets

Overview

Deploy a managed ruleset

Override a managed ruleset

Override examples

Overview

Set WordPress rules to Block

Enable only Joomla rules

Enable only selected rules

Deploy a managed ruleset with ruleset, tag, and rule overrides

Adjust the sensitivity of an HTTP DDoS rule to Low

Adjust an L3/4 DDoS rule ↗

Create an exception

Work with custom rulesets

Overview

Create a custom ruleset

Add rules to a custom ruleset

Deploy a custom ruleset

Rules language

Overview

Expressions

Overview

Edit in the dashboard

Operators and grouping symbols

Values

Actions

Fields

Overview

Fields reference

Functions

Rulesets API

Overview

JSON objects

Endpoints

List and view rulesets

Create a ruleset

Update or deploy a ruleset

Add a rule to a ruleset

Update a rule in a ruleset

Delete a rule in a ruleset

Delete a ruleset

Reference

Phases list

Agent resources

Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Ruleset Engine llms.txt ↗

Ruleset Engine llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗

Home

/Ruleset Engine

/Rulesets API

/Delete a ruleset

Delete a ruleset

Last updated Apr 16, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewDelete ruleset ExampleDelete ruleset version Example

You can use the API to delete all the versions of a ruleset or delete a specific version of a ruleset.

Delete ruleset (all versions)

Delete ruleset version

Delete ruleset

Deletes all the versions of an existing ruleset at the account or zone level.

Use one of the following API endpoints:

Delete an account ruleset
DELETE /accounts/{account_id}/rulesets/{ruleset_id}

Delete a zone ruleset
DELETE /zones/{zone_id}/rulesets/{ruleset_id}

If the delete operation succeeds, the API method call returns a 204 No Content HTTP status code.

Note

You cannot delete a ruleset that is still referenced in other rules. For example, you cannot delete a custom ruleset that is being deployed in a rule with execute action.

To delete the ruleset, update or delete any rules that reference the ruleset and try again.

Example

The following example request deletes an existing ruleset with ID $RULESET_ID.

Required API token permissions
At least one of the following token permissions is required:
Mass URL Redirects Write

Magic Firewall Write

L4 DDoS Managed Ruleset Write

Transform Rules Write

Select Configuration Write

Account WAF Write

Account Rulesets Write

Logs Write
Delete an account rulesetbashcurl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/rulesets/$RULESET_ID" \ --request DELETE \ --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Delete ruleset version

Deletes a specific version of a ruleset.

Use one of the following API endpoints:

Delete an account ruleset version
DELETE /accounts/{account_id}/rulesets/{ruleset_id}/versions/{version_number}

Delete a zone ruleset version
DELETE /zones/{zone_id}/rulesets/{ruleset_id}/versions/{version_number}

If the delete operation succeeds, the method call returns a 204 No Content HTTP status code.

Later updates to the ruleset will not reuse the version number of a deleted ruleset version.

Note

You cannot delete a ruleset version if it is the latest ruleset version and there is a rule with execute action deploying that ruleset.

To delete the ruleset version, update or delete any rules that reference the ruleset and try again.

Example

The following example request deletes a version of an existing ruleset.

Required API token permissions
At least one of the following token permissions is required:
Mass URL Redirects Write

Magic Firewall Write

L4 DDoS Managed Ruleset Write

Transform Rules Write

Select Configuration Write

Account WAF Write

Account Rulesets Write

Logs Write
Delete an account ruleset versionbashcurl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/rulesets/$RULESET_ID/versions/$RULESET_VERSION" \ --request DELETE \ --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

PreviousDelete a rule in a ruleset NextPhases list

Was this helpful?

YesNo

Edit page Report issue

On this page

Overview

Delete ruleset

Example

Delete ruleset version

Example

Edit page Report issue

Getting started
Plans Contact sales PartnersFind a partnerStartupsUnder attack?Domain name search

Company
AboutCareersInvestorsPressPress kitGlobal network

Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG

Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse

Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog

Developers
DocumentationLearning centerCommunity

Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform

Start BuildingLog In

© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices

Docs

------
导航页打开网址