Colour bar ranges

Create a colour bar range

Adds a range to the location's colour bar. It holds no items until they are created. Send an Idempotency-Key so that a repeat of the call does not add the range twice.

post/v1/locations/{locationId}/colour-bar-ranges

Request

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

Path parameters

locationIdstring 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 required

What the range's items are used as, such as colour or developer: a lower-case word of at most 30 characters.

listPricestring

The supplier's list price of one pack, VAT excluded.

namestring required

What the range is called at the location, at most 255 characters.

packSizeinteger

Grams in one pack. Leave out for a range whose items are used a whole pack at a time.

seriesstring

The supplier's name of the series.

Example request

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

Response

Created

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.