Skip to main content
POST
Advance a dispute

Authorizations

Authorization
string
header
required

API key sent as Authorization: Bearer <api-key>.

Path Parameters

disputeId
string
required

Delivery dispute id (prefixed dispute:).

Body

application/json
toState
enum<string>
required
Available options:
INVESTIGATING,
EVIDENCE_GATHERED,
OPERATOR_RESPONDED,
ADVERTISER_RESPONDED
actor
string

Defaults to the key's developerId.

notes
string | null
operatorResponse
object

Required when toState is OPERATOR_RESPONDED.

advertiserResponse
object

Required when toState is ADVERTISER_RESPONDED.

Response

The transitioned dispute.

ok
boolean
required
data
object
required

Route-specific payload. Operation responses refine this.

contractVersion
string
required
Allowed value: "v1.0"