Skip to navigation
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