> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update house discount

> Change the discount or notes on a 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](/v2/storefront/house-discounts/tasks/delete-house-discount) the row and
[create](/v2/storefront/house-discounts/tasks/create-house-discount) a new one.

## Request

```bash curl theme={null}
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

```json theme={null}
{
  "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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="House discount tasks" href="/v2/storefront/house-discounts/tasks" icon="list-check">
    All house-discount operations.
  </Card>

  <Card title="Delete house discount" href="/v2/storefront/house-discounts/tasks/delete-house-discount" icon="trash">
    Remove a row to re-key it to a different house.
  </Card>
</CardGroup>