POST
/
sessions
/
{id}
/
dispute
curl -X POST https://api.stableyard.fi/v2/sessions/ses_abc123/dispute \
  -H "Authorization: Bearer sy_secret_*" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Product not delivered",
    "description": "Customer reports item never arrived"
  }'

{
  "object": "session",
  "id": "ses_abc123",
  "status": "settled",
  "dispute": {
    "status": "flagged",
    "reason": "Product not delivered",
    "description": "Customer reports item never arrived",
    "createdAt": "2026-03-20T10:00:00.000Z"
  },
  "requestId": "req_abc123"
}
Flag a dispute on a settled session. Auth: sy_secret_*
​
id
string
required
Session ID of the settled session
​
reason
string
required
Reason for the dispute
​
description
string
Additional details about the dispute
curl -X POST https://api.stableyard.fi/v2/sessions/ses_abc123/dispute \
  -H "Authorization: Bearer sy_secret_*" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Product not delivered",
    "description": "Customer reports item never arrived"
  }'

{
  "object": "session",
  "id": "ses_abc123",
  "status": "settled",
  "dispute": {
    "status": "flagged",
    "reason": "Product not delivered",
    "description": "Customer reports item never arrived",
    "createdAt": "2026-03-20T10:00:00.000Z"
  },
  "requestId": "req_abc123"
}