Delete an IP Access rule

DELETE

https://api.cloudflare.com/client/v4/zones/{zone_id}/firewall/access_rules/rules/{identifier}

Last modified:2022-12-16 13:48:33

Deletes an IP Access rule defined at the zone level.

Optionally, you can use the cascade property to specify that you wish to delete similar rules in other zones managed by the same zone owner.

Request

Path Params

identifier

string

required

zone_id

string

required

Body Params application/json

cascade

enum<string>

optional

The level to attempt to delete similar rules defined for other zones with the same owner. The default value is none, which will only delete the current rule. Using basic will delete rules that match the same action (mode) and configuration, while using aggressive will delete rules that match the same configuration.

Allowed values:

nonebasicaggressive

Default:

none

Example

{
    "cascade": "none"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://api.cloudflare.com/client/v4/zones//firewall/access_rules/rules/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cascade": "none"
}'

Responses

🟢200Delete an IP Access rule response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "id": "92f17202ed8bd63d69a66b86a49a8f6b"
    },
    "success": true
}

🟢200Delete an IP Access rule response failure

Modified at 2022-12-16 13:48:33

Create an IP Access rule

Update an IP Access rule