disputes

Withdraw (discard) a draft evidence counter

Discard a draft counter you no longer want. The counter moves to withdrawn and stops appearing in the dispute's counter list. Only a draft can be withdrawn — withdrawing a submitted counter returns 400 (a submitted response is already with the processor and can't be retracted here).

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

Request

  • Base URL: https://dev-api.truemed.com
  • URL: https://dev-api.truemed.com/api/v1/disputes/{business_id}/counters/{counter_id}/withdraw
  • 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).

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.