Update house discount

PATCH /api/v2/storefront/house-discounts/{id} Partially updates a house discount. The houseDomain scope is immutable — to re-key a discount to a different house, delete the row and create a new one.

Request

curl

curl -X PATCH https://api.interchange.io/api/v2/storefront/house-discounts/17 \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "discountPercent": 15,
    "notes": "Raised to 15% for 2026 H2."
  }'

Parameters

Send only the fields you want to change.

Field	Type	Notes
`discountPercent`	number	Discount off the quote, `0`–`100`
`notes`	string \| null	Freeform notes, max 2000 chars. `null` clears notes

Response

{
  "id": "17",
  "storefrontId": "1234",
  "houseDomain": "nike.com",
  "scope": "brand",
  "discountPercent": 15,
  "notes": "Raised to 15% for 2026 H2.",
  "createdAt": "2026-06-27T15:00:00.000Z",
  "updatedAt": "2026-06-27T18:30:00.000Z",
  "createdBy": "operator@touchline.example"
}

Returns 200 with the updated row.

Errors

400 VALIDATION_ERROR — discountPercent outside 0–100.
404 NOT_FOUND — no house discount with this id on the storefront.
401 UNAUTHORIZED — missing or invalid bearer token.

See Errors for the full error contract.

House discount tasks

All house-discount operations.

Delete house discount

Remove a row to re-key it to a different house.

List house discounts Inventory sources

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Errors

House discount tasks

Delete house discount

​Request

​Parameters

​Response

​Errors

​Related

House discount tasks

Delete house discount

Request

Parameters

Response

Errors

Related