Skip to main content
POST
Open a delivery dispute

Authorizations

Authorization
string
header
required

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

Body

application/json
disputedPeriod
object
required
affectedSurface
object
required
claimedShortfall
object
required
openedBy
string

Actor attribution. Defaults to the key's developerId.

openedByRole
enum<string>

Who is opening. Anything other than "operator" defaults to "advertiser".

Available options:
advertiser,
operator
evidenceBundle
object

Frozen at open time. At least one of the three id arrays must be non-empty.

Response

The opened dispute.

ok
boolean
required
data
object
required

Route-specific payload. Operation responses refine this.

contractVersion
string
required
Allowed value: "v1.0"