API ReferenceDisputes

Update Dispute Counter

Save a draft counter's evidence. This is a full replacement of the draft's `evidence_items`, built for autosave — call it as the merchant edits. Only a counter still in the `draft` state can be saved; saving a submitted or withdrawn counter returns `400`. Pass the `revision` you last read. If the counter changed since then (e.g. another tab saved it), the request is rejected with `409` so you can reload rather than silently clobber the newer edit. Any attached `file_ids` must reference files you own, or the save is rejected with `422`.

Authentication

x-truemed-api-keystring

Sales channel API key for merchant server-to-server authentication

Path parameters

business_idstringRequired

The Truemed dispute ID (UUID).

counter_idstringRequired

The Truemed counter ID (UUID).

Request

Request body for CounterUpsertRequest
revisionintegerRequired

The revision you last read; the save is rejected (409) if the counter changed since.

evidence_itemslist of objectsOptionalDefaults to []
Full replacement of the draft's categorized evidence.

Response

Successful response
counter_idstring

Stable Truemed counter ID (UUID).

created_atdatetime
When this counter was created.
phaseenum
Dispute phase this counter responds to.
Allowed values:
revisioninteger

Optimistic-lock revision; echo it back on the next draft save to detect conflicts.

stateenum
Counter lifecycle state.
Allowed values:
updated_atdatetime
When this counter was last updated.
evidence_itemslist of objectsOptionalDefaults to []
The categorized evidence captured on this counter.
submitted_atdatetime or nullOptional
When this counter was submitted to the processor.
submitted_bystring or nullOptional

Email of the dashboard user who submitted this counter; null for drafts or API-key submissions.

Errors

400
Bad Request Error
404
Not Found Error
405
Method Not Allowed Error
500
Internal Server Error
501
Not Implemented Error