Skip to main content
PUT
/
api
/
return-policies
/
{id}
Upsert a return policy for a supplier
curl --request PUT \
  --url https://app.solya.app/api/return-policies/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requiresConditionAssessment": true,
  "requiresReasonCode": false,
  "restockingFeePct": 5.5,
  "returnWindowDays": 30
}
'
{
  "createdAt": "2026-01-10T08:00:00.000Z",
  "id": "policy-uuid-1",
  "organizationId": "org-uuid-123",
  "requiresConditionAssessment": true,
  "requiresReasonCode": false,
  "restockingFeePct": 5.5,
  "returnWindowDays": 30,
  "supplierId": "supplier-uuid-aaa",
  "updatedAt": "2026-06-05T12:00:00.000Z"
}

Authorizations

Authorization
string
header
required

User session token issued by NextAuth. For human users accessing Solya via the web application.

Path Parameters

id
string
required

Supplier ID (the unique key for a return policy within an organization)

Minimum string length: 1

Body

application/json
requiresConditionAssessment
boolean
required
requiresReasonCode
boolean
required
restockingFeePct
number
required
Required range: 0 <= x <= 100
returnWindowDays
integer
required
Required range: 0 <= x <= 3650

Response

Successful response

data
object
required
success
enum<boolean>
required
Available options:
true