Advance a dispute
Drive a dispute through the non-terminal legs of the state machine: INVESTIGATING (operator acknowledged + reviewing), EVIDENCE_GATHERED (evidence bundle collected), OPERATOR_RESPONDED (requires operatorResponse with stance + proposed remedy), and ADVERTISER_RESPONDED (requires advertiserResponse with stance). Terminal / special targets have dedicated routes: RESOLVED → /resolve, WITHDRAWN → /withdraw, ESCALATED → /escalate. Illegal transitions return 409. Requires scope settlement:write.
Authorizations
API key sent as Authorization: Bearer <api-key>.
Path Parameters
Delivery dispute id (prefixed dispute:).
Body
INVESTIGATING, EVIDENCE_GATHERED, OPERATOR_RESPONDED, ADVERTISER_RESPONDED Defaults to the key's developerId.
Required when toState is OPERATOR_RESPONDED.
Required when toState is ADVERTISER_RESPONDED.