Disputes
Dispute Create
Overview
The Dispute Create endpoint allows you to create a new dispute for an asset that has been reported or blocked. This is useful when you believe an asset has been incorrectly flagged or if you want to contest a blocking decision.
Authentication
This endpoint requires an API key. Include your API key in the request headers.
Request
Request Parameters
Parameter | Type | Required | Description |
---|---|---|---|
content | string | Yes | The URL or content identifier that you want to dispute |
email | string | No* | Contact email for the dispute. Required if the API key is not associated with a user that has an email |
description | string | No | Additional details or explanation for the dispute |
Response
Response Parameters
Parameter | Type | Description |
---|---|---|
id | string | The unique identifier for the created dispute |
content | string | The content (URL) that was disputed |
message | string | Optional message providing additional information |
Errors
Status Code | Error Code | Description |
---|---|---|
400 | BAD_REQUEST | Invalid input parameters or a dispute already exists for this asset with the provided email |
401 | UNAUTHORIZED | Missing or invalid API key |
404 | NOT_FOUND | The specified asset does not exist |
Notes
- A dispute can only be created once per email address for a specific asset
- If the asset is only blocked in EthPhishingDetect but not in ChainPatrol, a note will automatically be added to the dispute
- All disputes created via the API will have a system note indicating they were created via the API