Precursor

Get Zone Precursor Config

GET/zones/{zone_id}/precursor

Update Zone Precursor Config

PUT/zones/{zone_id}/precursor

ModelsExpand Collapse

PrecursorConfig object { mode, rules, show_interstitial }

mode: optional "off" or "monitor" or "arm"

Controls Precursor detection for the zone. off disables detection, monitor records detections without affecting bot scores, and arm allows detections to affect bot scores.

One of the following:

"off"

"monitor"

"arm"

rules: optional array of object { expression, show_interstitial, id, 2 more }

The ordered list of Precursor rules for the zone.

expression: string

The filter expression that determines which requests the rule matches.

maxLength4000

show_interstitial: boolean

Whether Precursor shows an interstitial when it takes action on a request.

id: optional string

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

description: optional string

An informative description of the rule.

enabled: optional boolean

Whether the rule is active.

show_interstitial: optional boolean

Whether Precursor shows an interstitial when it takes action on a request.