---
title: Common API calls
description: Example API requests for managing Advanced DNS Protection rules and settings.
image: https://developers.cloudflare.com/core-services-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/ddos-protection/llms.txt  
> Use this file to discover all available pages before exploring further.

[Skip to content](#%5Ftop) 

### Tags

[ REST API ](https://developers.cloudflare.com/search/?tags=REST%20API) 

# Common API calls

The following sections contain example requests for common API calls. For a list of available API endpoints, refer to [Endpoints](https://developers.cloudflare.com/ddos-protection/advanced-ddos-systems/api/dns-protection/#endpoints).

## Get all DNS protection rules

The following example retrieves the currently configured rules for Advanced DNS Protection.

Request

```

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/advanced_dns_protection/configs/dns_protection/rules" \

--header "Authorization: Bearer <API_TOKEN>"


```

```

---

{

  "result": [

    {

      "id": "<RULE_ID>",

      "scope": "<SCOPE>",

      "name": "<NAME>",

      "mode": "<MODE>",

      "profile_sensitivity": "<SENSITIVITY>",

      "rate_sensitivity": "<RATE>",

      "burst_sensitivity": "<BURST>",

      "created_on": "2023-10-01T13:10:38.762503+01:00",

      "modified_on": "2023-10-01T13:10:38.762503+01:00",

      }

    ],

  "success": true,

  "errors": [],

  "messages": []

}


```

### Create DNS protection rule

The following example creates an Advanced DNS Protection rule with a global scope.

Request

```

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/advanced_dns_protection/configs/dns_protection/rules" \

--header "Authorization: Bearer <API_TOKEN>" \

--data '{

  "scope": "global",

  "name": "global",

  "mode": "<MODE>",

  "rate_sensitivity": "<RATE>",

  "burst_sensitivity": "<BURST>",

  "profile_sensitivity": "<SENSITIVITY>"

}'


```

```

{

  "result": {

    "id": "<RULE_ID>",

    "scope": "global",

    "name": "global",

    "mode": "<MODE>",

    "rate_sensitivity": "<RATE>",

    "burst_sensitivity": "<BURST>",

    "profile_sensitivity": "<SENSITIVITY>",

    "created_on": "2023-10-01T13:10:38.762503+01:00",

    "modified_on": "2023-10-01T13:10:38.762503+01:00",

  },

  "success": true,

  "errors": [],

  "messages": []

}


```

Refer to [JSON objects](https://developers.cloudflare.com/ddos-protection/advanced-ddos-systems/api/dns-protection/json-objects/) for more information on the fields in the JSON body.

### Update DNS protection rule

The following example updates an existing DNS protection rule with ID `{rule_id}`.

The request body can contain only the fields you want to update (from `mode`, `profile_sensitivity`, `rate_sensitivity`, and `burst_sensitivity`).

Request

```

curl --request PATCH \

"https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/advanced_dns_protection/configs/dns_protection/rules/{rule_id}" \

--header "Authorization: Bearer <API_TOKEN>" \

--data '{

  "mode": "<NEW_MODE>",

  "profile_sensitivity": "<NEW_SENSITIVITY>",

  "rate_sensitivity": "<NEW_RATE>",

  "burst_sensitivity": "<NEW_BURST>"

}'


```

```

{

  "result": {

    "id": "<RULE_ID>",

    "scope": "<SCOPE>",

    "name": "<NAME>",

    "mode": "<NEW_MODE>",

    "profile_sensitivity": "<NEW_SENSITIVITY>",

    "rate_sensitivity": "<NEW_RATE>",

    "burst_sensitivity": "<NEW_BURST>",

    "created_on": "2023-10-01T13:10:38.762503+01:00",

    "modified_on": "2023-10-01T13:10:38.762503+01:00",

  },

  "success": true,

  "errors": [],

  "messages": []

}


```

Refer to [JSON objects](https://developers.cloudflare.com/ddos-protection/advanced-ddos-systems/api/dns-protection/json-objects/) for more information on the fields in the JSON body.

```json
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/ddos-protection/","name":"DDoS Protection"}},{"@type":"ListItem","position":3,"item":{"@id":"/ddos-protection/advanced-ddos-systems/","name":"Advanced DDoS systems"}},{"@type":"ListItem","position":4,"item":{"@id":"/ddos-protection/advanced-ddos-systems/api/","name":"API configuration"}},{"@type":"ListItem","position":5,"item":{"@id":"/ddos-protection/advanced-ddos-systems/api/dns-protection/","name":"Advanced DNS Protection"}},{"@type":"ListItem","position":6,"item":{"@id":"/ddos-protection/advanced-ddos-systems/api/dns-protection/examples/","name":"Common API calls"}}]}
```