Deploy a Managed Ruleset

You can deploy a Managed Ruleset at the account level or at the zone level.

To deploy a Managed Ruleset to a phase, use the Rulesets API .

Deploy a Managed Ruleset to a phase at the account level

Use the following workflow to deploy a Managed Ruleset to a phase at the account level.

Get your account ID.
Get the ID of the Managed Ruleset you wish to deploy. Refer to List existing rulesets for details.
Identify the phase where you want to deploy the Managed Ruleset. Ensure that the Managed Ruleset belongs to the same phase where you want to deploy it. To learn more about the available phases supported by each Cloudflare product, check the specific documentation for that product.
Add a rule to the account-level phase entry point ruleset that executes the Managed Ruleset.

Example

The following example deploys a Managed Ruleset to the http_request_firewall_managed phase of your account (<ACCOUNT_ID>) by creating a rule that executes the Managed Ruleset. The rules in the Managed Ruleset are executed when the zone name matches one of example.com or anotherexample.com.

---
header: Request
---
curl -X PUT \
"https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/rulesets/phases/http_request_firewall_managed/entrypoint" \
-H "Authorization: Bearer <API_TOKEN>" \
-d '{
  "rules": [
    {
      "action": "execute",
      "action_parameters": {
        "id": "<CLOUDFLARE_MANAGED_RULESET_ID>"
      },
      "expression": "cf.zone.name in {\"example.com\" \"anotherexample.com\"}",
      "description": "Execute Cloudflare Managed Ruleset on my account-level phase entry point"
    }
  ]
}'

---
header: Response
---
{
  "result": {
    "id": "<RULESET_ID>",
    "name": "Account-level phase entry point",
    "description": "",
    "kind": "root",
    "version": "5",
    "rules": [
      {
        "id": "<RULE_ID>",
        "version": "1",
        "action": "execute",
        "action_parameters": {
          "id": "<CLOUDFLARE_MANAGED_RULESET_ID>",
          "version": "latest"
        },
        "expression": "cf.zone.name in {\"example.com\" \"anotherexample.com\"}",
        "description": "Execute Cloudflare Managed Ruleset on my account-level phase entry point",
        "last_updated": "2021-03-18T18:30:08.122758Z",
        "ref": "<RULE_REF>",
        "enabled": true
      }
    ],
    "last_updated": "2021-03-18T18:30:08.122758Z",
    "phase": "http_request_firewall_managed"
  },
  "success": true,
  "errors": [],
  "messages": []
}