## Update Zone Precursor Config

`precursor.update(PrecursorUpdateParams**kwargs)  -> PrecursorConfig`

**put** `/zones/{zone_id}/precursor`

Updates the Precursor configuration for a zone.

`default_mode` sets the zone-level enforcement mode. `enforcement_rules`
is the ordered list of rules that override enforcement for matching
requests.

This is a partial update: only the fields present in the request body
are changed.

- Sending an empty array (`[]`) clears all enforcement rules.
- At least one of `default_mode` or `enforcement_rules` must be present;
  an empty body (`{}`) is rejected with `400`.
- Rule `id` is read-only (assigned by Cloudflare) and ignored on input.
- Rule `mode` must be `min-friction` or `max-security` (`off` is not a
  valid rule mode; use `default_mode` to disable enforcement).

### Parameters

- `zone_id: str`

  Identifier.

- `default_mode: Optional[Literal["off", "min-friction", "max-security"]]`

  The zone-level Precursor enforcement mode applied to requests that do
  not match a more specific enforcement rule.

  - `"off"`

  - `"min-friction"`

  - `"max-security"`

- `enforcement_rules: Optional[Iterable[EnforcementRuleParam]]`

  The ordered list of enforcement rules for the zone.

  - `expression: str`

    The filter expression that determines which requests the rule matches.

  - `mode: Literal["min-friction", "max-security"]`

    The override mode Precursor applies to requests matching an enforcement
    rule. Unlike `default_mode`, this cannot be `off`.

    - `"min-friction"`

    - `"max-security"`

  - `id: Optional[str]`

    The read-only identifier that Cloudflare assigns to the rule.

  - `description: Optional[str]`

    An informative description of the rule.

  - `enabled: Optional[bool]`

    Whether the rule is active.

### Returns

- `class PrecursorConfig: …`

  - `default_mode: Optional[Literal["off", "min-friction", "max-security"]]`

    The zone-level Precursor enforcement mode applied to requests that do
    not match a more specific enforcement rule.

    - `"off"`

    - `"min-friction"`

    - `"max-security"`

  - `enforcement_rules: Optional[List[EnforcementRule]]`

    The ordered list of enforcement rules for the zone.

    - `expression: str`

      The filter expression that determines which requests the rule matches.

    - `mode: Literal["min-friction", "max-security"]`

      The override mode Precursor applies to requests matching an enforcement
      rule. Unlike `default_mode`, this cannot be `off`.

      - `"min-friction"`

      - `"max-security"`

    - `id: Optional[str]`

      The read-only identifier that Cloudflare assigns to the rule.

    - `description: Optional[str]`

      An informative description of the rule.

    - `enabled: Optional[bool]`

      Whether the rule is active.

### 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
)
precursor_config = client.precursor.update(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    default_mode="min-friction",
)
print(precursor_config.default_mode)
```

#### 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"
      }
    }
  ],
  "success": true,
  "result": {
    "default_mode": "min-friction",
    "enforcement_rules": [
      {
        "expression": "http.request.uri.path eq \"/shop\"",
        "mode": "max-security",
        "id": "3a03d665bac043e3a684e0d385a4b1e2",
        "description": "Enforce max-security on the shop page",
        "enabled": true
      }
    ]
  }
}
```