disputes

Save (upsert) a draft evidence counter; optimistic-locked for autosave

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.

post/api/v1/disputes/{business_id}/counters/{counter_id}

Request

  • Base URL: https://dev-api.truemed.com
  • URL: https://dev-api.truemed.com/api/v1/disputes/{business_id}/counters/{counter_id}
  • Auth: API key in header x-truemed-api-key

Path parameters

business_idstring required

The Truemed dispute ID (UUID).

counter_idstring required

The Truemed counter ID (UUID).

Request body

revisioninteger required

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

Response

Successful response

counter_idstring required

Stable Truemed counter ID (UUID).

created_atstring date-time required

When this counter was created.

phase'inquiry' | 'dispute' | 'pre_arbitration' | 'arbitration' required

Which round of a dispute this is — orthogonal to DisputeState (comparison doc §4.3/§5).

revisioninteger required

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

state'draft' | 'submitted' | 'withdrawn' | 'superseded' required

Lifecycle of a dispute-evidence response (a "counter").

draft autosaves; submitted is terminal-for-this-round (one-shot to the processor); withdrawn is a discarded draft; superseded is a prior round's submission once a new phase opens. Only draft is mutable.

submitted_atstring date-time nullable

When this counter was submitted to the processor.

submitted_bystring nullable

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

updated_atstring date-time required

When this counter was last updated.

Changes

No recorded changes to this operation across all 1 revision of this API.