Skip to content
Cloudflare API
Start here
API Reference
Bot Management

Feedback

List zone feedback reports
GET/zones/{zone_id}/bot_management/feedback
Submit a feedback report
POST/zones/{zone_id}/bot_management/feedback
ModelsExpand Collapse
FeedbackReport = object { description, expression, first_request_seen_at, 8 more }
description: string
expression: string

Wirefilter expression describing the traffic being reported.

first_request_seen_at: string
formatdate-time
last_request_seen_at: string
formatdate-time
requests: number
formatint64
requests_by_attribute: RequestsByAttribute { metric, requests }

Top attributes contributing to the feedback sample. Keys include topASNs, topCountries, topHosts, topIPs, topJA3Hashes, topJA4s, topPaths, topUserAgents.

requests_by_score: RequestsByScore

Map of bot scores (1-99) to request counts. Sum must equal requests.

requests_by_score_src: RequestsByScoreSrc

Map of score source to request counts. Sum must equal requests.

type: FeedbackType

Type of feedback report.

created_at: optional string
formatdate-time
subtype: optional string
FeedbackType = "false_positive" or "false_negative"

Type of feedback report.

One of the following:
"false_positive"
"false_negative"
MetricRequests = object { metric, requests }
metric: string
requests: number
formatint64
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
requests: number
formatint64
RequestsByScore = map[number]

Map of bot scores (1-99) to request counts. Sum must equal requests.

RequestsByScoreSrc = map[number]

Map of score source to request counts. Sum must equal requests.

FeedbackListResponse = array of FeedbackReport { description, expression, first_request_seen_at, 8 more }
description: string
expression: string

Wirefilter expression describing the traffic being reported.

first_request_seen_at: string
formatdate-time
last_request_seen_at: string
formatdate-time
requests: number
formatint64
requests_by_attribute: RequestsByAttribute { metric, requests }

Top attributes contributing to the feedback sample. Keys include topASNs, topCountries, topHosts, topIPs, topJA3Hashes, topJA4s, topPaths, topUserAgents.

requests_by_score: RequestsByScore

Map of bot scores (1-99) to request counts. Sum must equal requests.

requests_by_score_src: RequestsByScoreSrc

Map of score source to request counts. Sum must equal requests.

type: FeedbackType

Type of feedback report.

created_at: optional string
formatdate-time
subtype: optional string