Skip to content
Stashtab Docs
Esc
↑↓navigate↵open⌘Jpreview

Resolve a deposit condition dispute

POST/v1/organizations/{orgId}/deposit-disputes/{disputeId}/resolution
Authorization
AuthorizationBasic auth · headerrequired

Registered confidential integration credentials. Keep the secret server-side.

or
CookieAPI key · headerrequired

Console-managed Vault session cookie; secure cookie naming may vary by environment.

or
AuthorizationBearer token (Vault TEST service token) · headerrequired

Customer- and resource-bound service grant, rechecked on every call. Existing Live opening-feed authority remains narrow; ordinary Test business requests refuse until shared Test composition is available.

or
AuthorizationBearer token (Vault organization API key) · headerrequired

Organization-owned credential with immutable mode and Read-only or Read/write permissions. Only explicitly declared ordinary customer operations accept it. Test business access refuses until shared Test composition is available; no staff, team, key-management or protocol authority is granted.

Path parameters
disputeIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
orgIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
Request body
requiredapplication/json
resolutionstringrequired
Allowed:accept_and_tokenizeship_back
submissionKeystringrequired
min length 8 · max length 128 · matches ^[A-Za-z0-9_.:-]+$
Responses
200

Success

dataobjectrequired
Show properties
effectsstring[]required
operationIdstringrequired
outcomestringrequired
disputeobjectrequired
Show properties
assessedConditionstringrequired
Allowed:nmlpmphpdmgno_damage_found
deadlineAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
declaredConditionstring | nullrequired
Show properties
Any of:
string
string
null
null
depositRefstring | nullrequired
disputeIdstringrequired
openedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
poNumberstringrequired
productIdstringrequired
purchaseOrderIdstringrequired
reasonstringrequired
Allowed:assessed_worseundeclared_extra
resolutionstring | nullrequired
Show properties
Any of:
string
string
null
null
resolvedAtstring<date-time> | nullrequired
Show properties
Any of:
string<date-time>
string<date-time>
null
null
resolvedBystring | nullrequired
Show properties
Any of:
string
string
null
null
statusstringrequired
Allowed:openresolved
unitRefstringrequired
reportRevisioninteger | nullrequired
Show properties
Any of:
integer
integer
null
null
metaobjectrequired
Show properties
requestIdstringrequired
default

Error

errorobjectrequired
Show properties
codestringrequired
Allowed:forbiddeninternal_errornot_foundprovider_data_invalidprovider_outcome_unknownprovider_unavailablerate_limitedstate_conflictunauthenticatedvalidation_errorwarehouse_not_ready
fieldsobject[]
Show properties
Array of object
codestringrequired
messagestringrequired
pathstringrequired
messagestringrequired
operationIdstring
metaobjectrequired
Show properties
requestIdstringrequired
Request
curl -X POST '/v1/organizations/org_example/deposit-disputes/dispute_demo_1/resolution' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "resolution": "accept_and_tokenize",
  "submissionKey": "resolve-dispute-demo-1"
}'
Response
{
  "data": {
    "effects": [
      "deposit_dispute_resolved",
      "purchase_order_report"
    ],
    "operationId": "operation_demo_1",
    "outcome": "confirmed",
    "dispute": {
      "assessedCondition": "lp",
      "deadlineAt": "2026-11-29T15:00:00.000Z",
      "declaredCondition": "nm",
      "depositRef": "deposit_demo_1",
      "disputeId": "dispute_demo_1",
      "openedAt": "2026-10-30T15:00:00.000Z",
      "poNumber": "PO-0001",
      "productId": "product_variant_lp_demo",
      "purchaseOrderId": "purchase_order_demo",
      "reason": "assessed_worse",
      "resolution": "accept_and_tokenize",
      "resolvedAt": "2026-11-02T15:00:00.000Z",
      "resolvedBy": "request",
      "status": "resolved",
      "unitRef": "receipt_line_demo:0"
    },
    "reportRevision": 2
  },
  "meta": {
    "requestId": "example-resolveDepositDispute"
  }
}

Was this page helpful?