POST /zones/{zone_id}/bot_management/feedback

Submit a feedback report for the specified zone. Use type to indicate whether the report is a false positive (good traffic flagged as bot) or a false negative (bot traffic missed). Furthermore, you can also use expression as a wirefilter to identify the affected traffic sample.

See more accepted API fields and expression types at https://developers.cloudflare.com/bots/concepts/feedback-loop/#api-fields and https://developers.cloudflare.com/bots/concepts/feedback-loop/#expression-fields, respectively.

Servers

https://api.cloudflare.com/client/v4

Path parameters

Name	Type	Required	Description
`zone_id`	String	Yes

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`subtype`	String	No
`description`	String	Yes
`last_request_seen_at`	String	Yes
`expression`	String	Yes	Wirefilter expression describing the traffic being reported.
`requests`	Integer	Yes
`requests_by_attribute`	Object	Yes	Top attributes contributing to the feedback sample. Keys include topASNs, topCountries, topHosts, topIPs, topJA3Hashes, topJA4s, topPaths, topUserAgents.
`requests_by_attribute.name`	Object	No
`requests_by_attribute.name.metric`	String	Yes
`requests_by_attribute.name.requests`	Integer	Yes
`first_request_seen_at`	String	Yes
`requests_by_score_src`	Object	Yes	Map of score source to request counts. Sum must equal `requests`.
`type`	String	Yes	Type of feedback report. Valid values: `"false_negative"` `"false_positive"`
`requests_by_score`	Object	Yes	Map of bot scores (1-99) to request counts. Sum must equal `requests`.
`created_at`	String	No

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.