Skip to main content
POST
Resolve a dispute

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Path Parameters

id
string
required

The id.

Body

application/json

Permissive resolve body (zod .passthrough()). action is validated against the enum in the use-case; notes is coerced via typeof==='string'; uploadedEvidence is sanitized field-by-field (only honored for action 'counter_evidence').

action
enum<string>
required

pay = pay the creator; pay_and_cut = pay then remove from the program; counter_evidence = contest with uploaded evidence.

Available options:
pay,
pay_and_cut,
counter_evidence
notes
string

Optional resolution notes.

uploadedEvidence
object[]

Counter-evidence files to attach (only honored for action 'counter_evidence'). Entries are ignored unless storagePath is under this dispute/company upload prefix and contentType is an accepted image type.

Response

Resolution result (under_review for counter_evidence; resolved_brand_paid with amountPaidCents for pay/pay_and_cut).

data
object
required

Resolve result. For counter_evidence: { success, status: 'under_review' }. For pay / pay_and_cut: { success, status: 'resolved_brand_paid', amountPaidCents, paidNotRemoved? }.