Colour bar ranges

Update a colour bar range

Changes only the fields in the request. Either all of them are changed or none. See ColourBarRangeUpdate for how to clear a field.

patch/v1/locations/{locationId}/colour-bar-ranges/{colourBarRangeId}

Request

  • Base URL: https://api.cliento.com
  • URL: https://api.cliento.com/v1/locations/{locationId}/colour-bar-ranges/{colourBarRangeId}
  • Auth: HTTP bearer

Path parameters

locationIdstring required
colourBarRangeIdstring required

Headers

Idempotency-Keystring

A value you make up for this one request, such as a UUID. Send the same value when you retry and the first answer is returned; see Retrying safely.

Request body

brandstring
kindstring
listPricestring
namestring
packSizeinteger

Grams in one pack. Changing it changes the pack size of every item of the range that has none of its own.

seriesstring

Example request

{
  "brand": "Wella",
  "kind": "colour",
  "listPrice": "137.00",
  "name": "Koleston Perfect ME+",
  "packSize": 60,
  "series": "KP ME+"
}

Response

OK

brandstring
createdAtstring date-time required
idstring required

Colour bar range id.

kindstring required

What the range's items are used as, such as colour or developer. A lower-case word; the list is open.

listPricestring

The supplier's list price of one pack, VAT excluded, as a decimal string in the location's currency.

locationIdstring required
namestring required

What the range is called at the location.

packSizeinteger

Grams in one pack of the range's items. Left out for a range whose items are used a whole pack at a time.

seriesstring

The supplier's name of the series.

updatedAtstring date-time required

When the range itself was last changed.

Example response

{
  "brand": "Wella",
  "createdAt": "2026-10-12T08:15:30Z",
  "id": "cbr_7Hc2Lm9QxT4vBn6KdR1WsP",
  "kind": "colour",
  "listPrice": "137.00",
  "locationId": "loc_4fK9xQ2mLr8TzB1vNc7HdW",
  "name": "Koleston Perfect ME+",
  "packSize": 60,
  "series": "KP ME+",
  "updatedAt": "2026-10-12T08:15:30Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.