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
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 account ruleset | DELETE /accounts/{account-id}/rulesets/{ruleset-id} |
| Delete 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.
Example
The following example request deletes an existing ruleset.
Requestcurl -X DELETE \ -H "X-Auth-Email: user@example.com" \ -H "X-Auth-Key: REDACTED" \ "https://api.cloudflare.com/client/v4/accounts/{account-id}/rulesets/{ruleset-id}"
Delete ruleset version
Deletes a specific version of a ruleset.
Use one of the following API endpoints:
| Operation | Method + Endpoint |
|---|---|
| Delete a version of an account ruleset | DELETE /accounts/{account-id}/rulesets/{ruleset-id}/versions/{version-number} |
| Delete a version of a zone ruleset | 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.
Example
The following example request deletes a version of an existing ruleset.
Requestcurl -X DELETE \ -H "X-Auth-Email: user@example.com" \ -H "X-Auth-Key: REDACTED" \ "https://api.cloudflare.com/client/v4/accounts/{account-id}/rulesets/{ruleset-id}/versions/{version-number}"