--- title: Bot Management --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Bot Management ##### [Get Zone Bot Management Config](https://developers.cloudflare.com/api/resources/bot_management/methods/get) GET/zones/{zone\_id}/bot\_management ##### [Update Zone Bot Management Config](https://developers.cloudflare.com/api/resources/bot_management/methods/update) PUT/zones/{zone\_id}/bot\_management ##### ModelsExpand Collapse

BotFightModeConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 12 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property bot\_preference\_sync\_enabled: optional boolean Enable Bot Preference Sync for this zone. When enabled, Cloudflare can serve robots.txt content derived from the zone’s AI Search, AI User, and AI Training preferences. Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

content\_bots\_protection: optional "block"or "disabled" Enable rule to block content bots. When enabled, blocks automated traffic with low bot scores, excluding safe verified bot categories. Exceptions should be managed via skip rules.

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property fight\_mode: optional boolean Whether to enable Bot Fight Mode. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property

stale\_zone\_configuration: optional object {optimize\_wordpress, sbfm\_definitely\_automated, sbfm\_likely\_automated, 3 more } A read-only field that shows which unauthorized settings are currently active on the zone. These settings typically result from upgrades or downgrades.

optimize\_wordpress: optional boolean Indicates that the zone’s wordpress optimization for SBFM is turned on. Link to this property sbfm\_definitely\_automated: optional string Indicates that the zone’s definitely automated requests are being blocked or challenged. Link to this property sbfm\_likely\_automated: optional string Indicates that the zone’s likely automated requests are being blocked or challenged. Link to this property sbfm\_static\_resource\_protection: optional string Indicates that the zone’s static resource protection is turned on. Link to this property sbfm\_verified\_bots: optional string Indicates that the zone’s verified bot requests are being blocked. Link to this property suppress\_session\_score: optional boolean Indicates that the zone’s session score tracking is disabled. Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

[Link to this property](<#(resource)%20bot_management%20%3E%20(model)%20bot_fight_mode_configuration%20%3E%20(schema)>)

SubscriptionConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 14 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property auto\_update\_model: optional boolean Automatically update to the newest bot detection models created by Cloudflare as they are released. Learn more. Link to this property bm\_cookie\_enabled: optional boolean Indicates that the bot management cookie can be placed on end user devices accessing the site. Defaults to true Link to this property bot\_preference\_sync\_enabled: optional boolean Enable Bot Preference Sync for this zone. When enabled, Cloudflare can serve robots.txt content derived from the zone’s AI Search, AI User, and AI Training preferences. Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property

stale\_zone\_configuration: optional object {fight\_mode, optimize\_wordpress, sbfm\_definitely\_automated, 3 more } A read-only field that shows which unauthorized settings are currently active on the zone. These settings typically result from upgrades or downgrades.

fight\_mode: optional boolean Indicates that the zone’s Bot Fight Mode is turned on. Link to this property optimize\_wordpress: optional boolean Indicates that the zone’s wordpress optimization for SBFM is turned on. Link to this property sbfm\_definitely\_automated: optional string Indicates that the zone’s definitely automated requests are being blocked or challenged. Link to this property sbfm\_likely\_automated: optional string Indicates that the zone’s likely automated requests are being blocked or challenged. Link to this property sbfm\_static\_resource\_protection: optional string Indicates that the zone’s static resource protection is turned on. Link to this property sbfm\_verified\_bots: optional string Indicates that the zone’s verified bot requests are being blocked. Link to this property

Link to this property suppress\_session\_score: optional boolean Whether to disable tracking the highest bot score for a session in the Bot Management cookie. Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

[Link to this property](<#(resource)%20bot_management%20%3E%20(model)%20subscription_configuration%20%3E%20(schema)>)

SuperBotFightModeDefinitelyConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 15 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property optimize\_wordpress: optional boolean Whether to optimize Super Bot Fight Mode protections for Wordpress. Link to this property

sbfm\_definitely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on definitely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

Link to this property sbfm\_static\_resource\_protection: optional boolean Super Bot Fight Mode (SBFM) to enable static resource protection. Enable if static resources on your application need bot protection. Note: Static resource protection can also result in legitimate traffic being blocked. Link to this property

sbfm\_verified\_bots: optional "allow"or "block" Super Bot Fight Mode (SBFM) action to take on verified bots requests.

One of the following: "allow" Link to this property "block" Link to this property

Link to this property

stale\_zone\_configuration: optional object {fight\_mode, sbfm\_likely\_automated } A read-only field that shows which unauthorized settings are currently active on the zone. These settings typically result from upgrades or downgrades.

fight\_mode: optional boolean Indicates that the zone’s Bot Fight Mode is turned on. Link to this property sbfm\_likely\_automated: optional string Indicates that the zone’s likely automated requests are being blocked or challenged. Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

[Link to this property](<#(resource)%20bot_management%20%3E%20(model)%20super_bot_fight_mode_definitely_configuration%20%3E%20(schema)>)

SuperBotFightModeLikelyConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 16 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property optimize\_wordpress: optional boolean Whether to optimize Super Bot Fight Mode protections for Wordpress. Link to this property

sbfm\_definitely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on definitely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

Link to this property

sbfm\_likely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on likely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

sbfm\_verified\_bots: optional "allow"or "block" Super Bot Fight Mode (SBFM) action to take on verified bots requests.

One of the following: "allow" Link to this property "block" Link to this property

Link to this property

stale\_zone\_configuration: optional object {fight\_mode } A read-only field that shows which unauthorized settings are currently active on the zone. These settings typically result from upgrades or downgrades.

fight\_mode: optional boolean Indicates that the zone’s Bot Fight Mode is turned on. Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

[Link to this property](<#(resource)%20bot_management%20%3E%20(model)%20super_bot_fight_mode_likely_configuration%20%3E%20(schema)>)

BotManagementGetResponse = BotFightModeConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 12 more } or SuperBotFightModeDefinitelyConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 15 more } or SuperBotFightModeLikelyConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 16 more } or SubscriptionConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 14 more }

One of the following:

BotFightModeConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 12 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

Link to this property

SuperBotFightModeDefinitelyConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 15 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property optimize\_wordpress: optional boolean Whether to optimize Super Bot Fight Mode protections for Wordpress. Link to this property

sbfm\_definitely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on definitely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

sbfm\_verified\_bots: optional "allow"or "block" Super Bot Fight Mode (SBFM) action to take on verified bots requests.

One of the following: "allow" Link to this property "block" Link to this property

Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

Link to this property

SuperBotFightModeLikelyConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 16 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property optimize\_wordpress: optional boolean Whether to optimize Super Bot Fight Mode protections for Wordpress. Link to this property

sbfm\_definitely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on definitely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

Link to this property

sbfm\_likely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on likely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

sbfm\_verified\_bots: optional "allow"or "block" Super Bot Fight Mode (SBFM) action to take on verified bots requests.

One of the following: "allow" Link to this property "block" Link to this property

Link to this property

fight\_mode: optional boolean Indicates that the zone’s Bot Fight Mode is turned on. Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

Link to this property

SubscriptionConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 14 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property

Link to this property

[Link to this property](<#(resource)%20bot_management%20%3E%20(model)%20bot_management_get_response%20%3E%20(schema)>)

BotManagementUpdateResponse = BotFightModeConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 12 more } or SuperBotFightModeDefinitelyConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 15 more } or SuperBotFightModeLikelyConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 16 more } or SubscriptionConfiguration { ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 14 more }

One of the following:

BotFightModeConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 12 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

Link to this property

SuperBotFightModeDefinitelyConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 15 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property optimize\_wordpress: optional boolean Whether to optimize Super Bot Fight Mode protections for Wordpress. Link to this property

sbfm\_definitely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on definitely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

sbfm\_verified\_bots: optional "allow"or "block" Super Bot Fight Mode (SBFM) action to take on verified bots requests.

One of the following: "allow" Link to this property "block" Link to this property

Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

Link to this property

SuperBotFightModeLikelyConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 16 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property optimize\_wordpress: optional boolean Whether to optimize Super Bot Fight Mode protections for Wordpress. Link to this property

sbfm\_definitely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on definitely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

Link to this property

sbfm\_likely\_automated: optional "allow"or "block"or "managed\_challenge" Super Bot Fight Mode (SBFM) action to take on likely automated requests.

One of the following: "allow" Link to this property "block" Link to this property "managed\_challenge" Link to this property

sbfm\_verified\_bots: optional "allow"or "block" Super Bot Fight Mode (SBFM) action to take on verified bots requests.

One of the following: "allow" Link to this property "block" Link to this property

Link to this property

fight\_mode: optional boolean Indicates that the zone’s Bot Fight Mode is turned on. Link to this property

Link to this property using\_latest\_model: optional boolean A read-only field that indicates whether the zone currently is running the latest ML model. Link to this property

Link to this property

SubscriptionConfiguration object {ai\_bots\_migration\_opt\_out, ai\_bots\_protection, ai\_search, 14 more }

ai\_bots\_migration\_opt\_out: optional boolean Temporary migration flag tracking zones opted out of AI bots managed-rule updates. Link to this property

ai\_bots\_protection: optional "block"or "disabled"or "only\_on\_ad\_pages" Enable rule to block AI Scrapers and Crawlers.

One of the following: "block" Link to this property "disabled" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_search: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI search bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_training: optional "disabled"or "disallow"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI model training bots.

One of the following: "disabled" Link to this property "disallow" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

Link to this property

ai\_user: optional "disabled"or "block"or "only\_on\_ad\_pages" Configure robots.txt policy for AI assistant and agent bots.

One of the following: "disabled" Link to this property "block" Link to this property "only\_on\_ad\_pages" Link to this property

cf\_robots\_variant: optional "off"or "policy\_only" Specifies the Robots Access Control License variant to use.

One of the following: "off" Link to this property "policy\_only" Link to this property

Link to this property

One of the following: "block" Link to this property "disabled" Link to this property

Link to this property

crawler\_protection: optional "enabled"or "disabled" Enable rule to punish AI Scrapers and Crawlers via a link maze.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property enable\_js: optional boolean Use lightweight, invisible JavaScript detections to improve Bot Management. Learn more about JavaScript Detections. Link to this property is\_robots\_txt\_managed: optional boolean Enable cloudflare managed robots.txt. If an existing robots.txt is detected, then managed robots.txt will be prepended to the existing robots.txt. Link to this property jsd\_api\_results\_enabled: optional boolean Whether to use JavaScript Detection results submitted through the API for this zone. Link to this property

Link to this property

[Link to this property](<#(resource)%20bot_management%20%3E%20(model)%20bot_management_update_response%20%3E%20(schema)>) #### Bot ManagementFeedback ##### [List zone feedback reports](https://developers.cloudflare.com/api/resources/bot_management/subresources/feedback/methods/list) GET/zones/{zone\_id}/bot\_management/feedback ##### [Submit a feedback report](https://developers.cloudflare.com/api/resources/bot_management/subresources/feedback/methods/create) POST/zones/{zone\_id}/bot\_management/feedback ##### ModelsExpand Collapse

FeedbackReport object {description, expression, first\_request\_seen\_at, 8 more }

description: string Link to this property expression: string Wirefilter expression describing the traffic being reported. Link to this property first\_request\_seen\_at: string formatdate-time Link to this property last\_request\_seen\_at: string formatdate-time Link to this property requests: number formatint64 Link to this property requests\_by\_attribute: RequestsByAttribute { metric, requests } Top attributes contributing to the feedback sample. Keys include topASNs, topCountries, topHosts, topIPs, topJA3Hashes, topJA4s, topPaths, topUserAgents. Link to this property requests\_by\_score: RequestsByScore Map of bot scores (1-99) to request counts. Sum must equal requests. Link to this property requests\_by\_score\_src: RequestsByScoreSrc Map of score source to request counts. Sum must equal requests. Link to this property type: FeedbackType Type of feedback report. Link to this property created\_at: optional string formatdate-time Link to this property subtype: optional string Link to this property

[Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20feedback_report%20%3E%20(schema)>)

FeedbackType = "false\_positive"or "false\_negative" Type of feedback report.

One of the following: "false\_positive" Link to this property "false\_negative" Link to this property

[Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20feedback_type%20%3E%20(schema)>)

MetricRequests object {metric, requests }

metric: string Link to this property requests: number formatint64 Link to this property

[Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20metric_requests%20%3E%20(schema)>)

RequestsByAttribute = map\[array of MetricRequests { metric, requests } ] Top attributes contributing to the feedback sample. Keys include topASNs, topCountries, topHosts, topIPs, topJA3Hashes, topJA4s, topPaths, topUserAgents.

metric: string Link to this property requests: number formatint64 Link to this property

[Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20requests_by_attribute%20%3E%20(schema)>) RequestsByScore = map\[number] Map of bot scores (1-99) to request counts. Sum must equal `requests`. [Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20requests_by_score%20%3E%20(schema)>) RequestsByScoreSrc = map\[number] Map of score source to request counts. Sum must equal `requests`. [Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20requests_by_score_src%20%3E%20(schema)>)

FeedbackListResponse = array of FeedbackReport { description, expression, first\_request\_seen\_at, 8 more }

[Link to this property](<#(resource)%20bot_management.feedback%20%3E%20(model)%20feedback_list_response%20%3E%20(schema)>)