Skip to content

Dispute programs: accept, answer, appeal, decide

The Dispute Verbs accept, answer, appeal, decide as MCP do programs, with inputs, result, refusals and an example.

Reference for Dispute, one group of Dispute programs.

Dispute.accept

Accept concedes an open Dispute without contest, so the buyer keeps the held amount and the Dispute closes. Verb page.

Text
do: return await $.Dispute.accept(input)

Emits Dispute.accepted.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe open Dispute.
reasontextrequiredWhy contesting is not worth it, such as a fraud chargeback with no delivery Evidence.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe closed Dispute, decided for the buyer.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Dispute.accept({ dispute: 'dp_gywlshZJ7A', reason: 'Example reason' })"
  }
}

Dispute.answer

Answer submits the seller’s Evidence on an open Dispute before its deadline: the contract, the delivered work, and its verdicts. Verb page.

Text
do: return await $.Dispute.answer(input)

Emits Dispute.answered.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe open Dispute.
evidencelist of EvidencerequiredThe records that show the promise was kept.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe answered Dispute.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Dispute.answer({ dispute: 'dp_gywlshZJ7A', evidence: ['evidence_6xsa6iYImd'] })"
  }
}

Dispute.appeal

Appeal asks for one review of a decided Dispute by a Worker who took no part in the first decision. Verb page.

Text
do: return await $.Dispute.appeal(input)

Emits Dispute.appealed.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe decided Dispute.
reasontextrequiredWhat the first decision got wrong.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe appealed Dispute.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Dispute.appeal({ dispute: 'dp_gywlshZJ7A', reason: 'Example reason' })"
  }
}

Dispute.decide

Decide rules on an answered Dispute for the buyer, the seller, or a split, and releases or returns the held amount. Verb page.

Text
do: return await $.Dispute.decide(input)

Emits Dispute.decided.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe answered Dispute.
decisionstringrequiredOne of buyer, seller, or split.
reasontextrequiredWhy, citing the Evidence and the contract term it turns on.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe decided Dispute.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Dispute.decide({ dispute: 'dp_gywlshZJ7A', decision: 'buyer', reason: 'Example reason' })"
  }
}