---
title: Delete a rule in a ruleset · Cloudflare Ruleset Engine docs
description: Deletes a single rule in a ruleset at the account or zone level.
lastUpdated: 2025-04-01T09:53:33.000Z
source_url:
  html: https://kate-fixes-idpoktalogin.preview.developers.cloudflare.com/ruleset-engine/rulesets-api/delete-rule/index.md
  md: https://kate-fixes-idpoktalogin.preview.developers.cloudflare.com/ruleset-engine/rulesets-api/delete-rule/
---

Deletes a single rule in a ruleset at the account or zone level.

Use one of the following API endpoints:

| Operation | Method + Endpoint |
| - | - |
| [Delete an account ruleset rule](https://developers.cloudflare.com/api/resources/rulesets/subresources/rules/methods/delete/) | `DELETE /accounts/{account_id}/rulesets/{ruleset_id}/rules/{rule_id}` |
| [Delete a zone ruleset rule](https://developers.cloudflare.com/api/resources/rulesets/methods/delete/) | `DELETE /zones/{zone_id}/rulesets/{ruleset_id}/rules/{rule_id}` |

If the delete operation succeeds, the API method call returns a `200 OK` HTTP status code with the complete ruleset in the response body.

## Example

The following example deletes rule `$RULE_ID_1` belonging to ruleset `$RULESET_ID`.

The response will include the complete ruleset after deleting the rule.

```bash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/rulesets/$RULESET_ID/rules/$RULE_ID_1" \
  --request DELETE \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```

```json
{
  "result": {
    "id": "<RULESET_ID>",
    "name": "Custom Ruleset 1",
    "description": "My first custom ruleset",
    "kind": "custom",
    "version": "12",
    "rules": [
      {
        "id": "<RULE_ID_2>",
        "version": "2",
        "action": "js_challenge",
        "expression": "(ip.src.country eq \"GB\" or ip.src.country eq \"FR\") or cf.threat_score > 0",
        "description": "challenge GB and FR or based on IP Reputation",
        "last_updated": "2021-07-22T12:54:58.144683Z",
        "ref": "<RULE_REF_2>",
        "enabled": true
      }
    ],
    "last_updated": "2021-07-22T12:54:58.144683Z",
    "phase": "http_request_firewall_custom"
  },
  "success": true,
  "errors": [],
  "messages": []
}
```
