--- title: Request review on mitigations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Abuse Reports](https://developers.cloudflare.com/api/resources/abuse_reports) [Mitigations](https://developers.cloudflare.com/api/resources/abuse_reports/subresources/mitigations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Request review on mitigations POST/accounts/{account\_id}/abuse-reports/{report\_id}/mitigations/appeal Request a review of mitigations applied because of an abuse report, or submit a report-level appeal. - To request a review of specific mitigations, send `appeals` with the mitigation IDs and reasons. Repeating a request for a mitigation with an unresolved appeal is idempotent and returns that mitigation in the in-review state. - To submit a report-level appeal, send `type` and, for a `counter_notice`, the counter-notice details in `data`. Report-level appeals are currently available only for DMCA (copyright) reports. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### Accepted Permissions (at least one required) `Trust and Safety Write` ##### P ath ParametersExpand Collapse account\_id: string maxLength32 [Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) report\_id: string [Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(params)%20default%20%3E%20(param)%20report_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse
appeals: optional array of object {id, reason } List of mitigations to appeal. id: string ID of the mitigation to appeal. Link to this property
reason: "removed"or "misclassified" Reason why the customer is appealing. One of the following: "removed" Link to this property "misclassified" Link to this property
Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(params)%200%20%3E%20(param)%20appeals%20%3E%20(schema)>)
data: optional object {city, country, email, 11 more } Counter-notice details supporting an appeal. city: string Link to this property country: string Link to this property email: string formatemail Link to this property full\_name: string Link to this property jurisdiction\_consent: boolean Link to this property perjury\_attestation: boolean Link to this property phone\_number: string Link to this property signature: string Link to this property state: string Link to this property street\_address: string Link to this property urls: array of string Link to this property zip\_code: string Link to this property company: optional string Link to this property counter\_notice\_response: optional string Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(params)%200%20%3E%20(param)%20data%20%3E%20(schema)>)
type: optional "counter\_notice"or "content\_removed" The type of appeal being submitted. One of the following: "counter\_notice" Link to this property "content\_removed" Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(params)%200%20%3E%20(param)%20type%20%3E%20(schema)>) ##### ReturnsExpand Collapse
result\_info: object {count, page, per\_page, 2 more } count: number Link to this property page: number Link to this property per\_page: number Link to this property total\_count: number Link to this property total\_pages: number Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) success: boolean [Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
errors: optional array of object {message } message: string Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: optional array of object {message } message: string Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: optional array of object {id, effective\_date, entity\_id, 3 more } id: string ID of remediation. Link to this property effective\_date: string Date when the mitigation will become active. Time in RFC 3339 format (https://www.rfc-editor.org/rfc/rfc3339.html) Link to this property entity\_id: string Link to this property
entity\_type: "url\_pattern"or "account"or "zone"or "custom\_expression" The type of entity targeted by a mitigation. One of the following: "url\_pattern" Link to this property "account" Link to this property "zone" Link to this property "custom\_expression" Link to this property
Link to this property
status: "pending"or "active"or "in\_review"or 2 more The status of a mitigation One of the following: "pending" Link to this property "active" Link to this property "in\_review" Link to this property "cancelled" Link to this property "removed" Link to this property
Link to this property type: string The type of mitigation applied to a reported entity. Link to this property
[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20review%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Request review on mitigations HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/abuse-reports/$REPORT_ID/mitigations/appeal \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "type": "counter_notice" }' ``` 200 example ``` { "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 }, "success": true, "errors": [ { "message": "message" } ], "messages": [ { "message": "message" } ], "result": [ { "id": "id", "effective_date": "2009-11-10T23:00:00Z", "entity_id": "entity_id", "entity_type": "url_pattern", "status": "pending", "type": "type" } ] } ``` ##### Returns Examples 200 example ``` { "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 }, "success": true, "errors": [ { "message": "message" } ], "messages": [ { "message": "message" } ], "result": [ { "id": "id", "effective_date": "2009-11-10T23:00:00Z", "entity_id": "entity_id", "entity_type": "url_pattern", "status": "pending", "type": "type" } ] } ```