## Update a firewall rule

`firewall.rules.update(strrule_id, RuleUpdateParams**kwargs)  -> FirewallRule`

**put** `/zones/{zone_id}/firewall/rules/{rule_id}`

Updates an existing firewall rule.

### Parameters

- `zone_id: str`

  Defines an identifier.

- `rule_id: str`

  The unique identifier of the firewall rule.

- `action: Action`

  The action to perform when the threshold of matched traffic within the configured period is exceeded.

  - `mode: Optional[Literal["simulate", "ban", "challenge", 2 more]]`

    The action to perform.

    - `"simulate"`

    - `"ban"`

    - `"challenge"`

    - `"js_challenge"`

    - `"managed_challenge"`

  - `response: Optional[ActionResponse]`

    A custom content type and reponse to return when the threshold is exceeded. The custom response configured in this object will override the custom error for the zone. This object is optional.
    Notes: If you omit this object, Cloudflare will use the default HTML error page. If "mode" is "challenge", "managed_challenge", or "js_challenge", Cloudflare will use the zone challenge pages and you should not provide the "response" object.

    - `body: Optional[str]`

      The response body to return. The value must conform to the configured content type.

    - `content_type: Optional[str]`

      The content type of the body. Must be one of the following: `text/plain`, `text/xml`, or `application/json`.

  - `timeout: Optional[float]`

    The time in seconds during which Cloudflare will perform the mitigation action. Must be an integer value greater than or equal to the period.
    Notes: If "mode" is "challenge", "managed_challenge", or "js_challenge", Cloudflare will use the zone's Challenge Passage time and you should not provide this value.

- `filter: FirewallFilterParam`

  - `id: Optional[str]`

    The unique identifier of the filter.

  - `description: Optional[str]`

    An informative summary of the filter.

  - `expression: Optional[str]`

    The filter expression. For more information, refer to [Expressions](https://developers.cloudflare.com/ruleset-engine/rules-language/expressions/).

  - `paused: Optional[bool]`

    When true, indicates that the filter is currently paused.

  - `ref: Optional[str]`

    A short reference tag. Allows you to select related filters.

### Returns

- `class FirewallRule: …`

  - `id: Optional[str]`

    The unique identifier of the firewall rule.

  - `action: Optional[Action]`

    The action to apply to a matched request. The `log` action is only available on an Enterprise plan.

    - `"block"`

    - `"challenge"`

    - `"js_challenge"`

    - `"managed_challenge"`

    - `"allow"`

    - `"log"`

    - `"bypass"`

  - `description: Optional[str]`

    An informative summary of the firewall rule.

  - `filter: Optional[Filter]`

    - `class FirewallFilter: …`

      - `id: Optional[str]`

        The unique identifier of the filter.

      - `description: Optional[str]`

        An informative summary of the filter.

      - `expression: Optional[str]`

        The filter expression. For more information, refer to [Expressions](https://developers.cloudflare.com/ruleset-engine/rules-language/expressions/).

      - `paused: Optional[bool]`

        When true, indicates that the filter is currently paused.

      - `ref: Optional[str]`

        A short reference tag. Allows you to select related filters.

    - `class DeletedFilter: …`

      - `id: str`

        The unique identifier of the filter.

      - `deleted: bool`

        When true, indicates that the firewall rule was deleted.

  - `paused: Optional[bool]`

    When true, indicates that the firewall rule is currently paused.

  - `priority: Optional[float]`

    The priority of the rule. Optional value used to define the processing order. A lower number indicates a higher priority. If not provided, rules with a defined priority will be processed before rules without a priority.

  - `products: Optional[List[Product]]`

    - `"zoneLockdown"`

    - `"uaBlock"`

    - `"bic"`

    - `"hot"`

    - `"securityLevel"`

    - `"rateLimit"`

    - `"waf"`

  - `ref: Optional[str]`

    A short reference tag. Allows you to select related firewall rules.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
firewall_rule = client.firewall.rules.update(
    rule_id="372e67954025e0ba6aaa6d586b9e0b60",
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    action={},
    filter={},
)
print(firewall_rule.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "372e67954025e0ba6aaa6d586b9e0b60",
    "action": "block",
    "description": "Blocks traffic identified during investigation for MIR-31",
    "filter": {
      "id": "372e67954025e0ba6aaa6d586b9e0b61",
      "description": "Restrict access from these browsers on this address range.",
      "expression": "(http.request.uri.path ~ \".*wp-login.php\" or http.request.uri.path ~ \".*xmlrpc.php\") and ip.addr ne 172.16.22.155",
      "paused": false,
      "ref": "FIL-100"
    },
    "paused": false,
    "priority": 50,
    "products": [
      "waf"
    ],
    "ref": "MIR-31"
  },
  "success": true
}
```