Delete rulesets

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:

Operation	Method + Endpoint
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.

curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id}/rulesets/{ruleset_id} \
--header "Authorization: Bearer <API_TOKEN>"

Delete ruleset version

Deletes a specific version of a ruleset.

Use one of the following API endpoints:

Operation	Method + Endpoint
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.

curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id}/rulesets/{ruleset_id}/versions/{version_number} \
--header "Authorization: Bearer <API_TOKEN>"

Was this helpful?

What did you like?

Accurate

Easy to understand

Solved my problem

Helped me decide to use the product

Other

What went wrong?

Hard to understand

Incorrect information

Missing the information

Other

Thank you for helping improve Cloudflare's documentation!