Skip to main content
POST
/
product-values
Upsert a product value override
curl --request POST \
  --url https://api.simcel.io/master/v1/product-values \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspaceId": "ws_abc123",
  "planId": "plan_9xKz2",
  "productId": "SKU-001",
  "customerRef": "CUST-FR-001",
  "name": "GrossSalesValue",
  "value": 26,
  "startDate": "2025-07-01",
  "endDate": "2025-12-31"
}
'
{
  "success": true,
  "overrideId": "<string>",
  "appliedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
workspaceId
string
required
​
planId
string
required

Plan ID — pricing overrides are scoped to a specific plan

​
productId
string
required
​
customerRef
string
required
​
name
enum<string>
required
Available options:
GrossSalesValue,
ListedPrice,
GrossSalesValuePerKg,
ListedPricePerKg
​
value
number
required
​
startDate
string<date>
required
​
endDate
string<date>
required

Response

Product value upserted successfully

​
success
boolean
​
overrideId
string

Internal ID of the created/updated override record

​
appliedAt
string<date-time>