---
title: "Create a colour bar range"
method: POST
path: "/v1/locations/{locationId}/colour-bar-ranges"
tags: ["Colour bar ranges"]
---

# Create a colour bar range

`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

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.

## Path parameters

- `locationId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- ColourBarRangeCreate
  - `brand` string
  - `kind` string, required: What the range's items are used as, such as `colour` or `developer`: a lower-case word of at most 30 characters.
  - `listPrice` string: The supplier's list price of one pack, VAT excluded.
  - `name` string, required: What the range is called at the location, at most 255 characters.
  - `packSize` integer: Grams in one pack. Leave out for a range whose items are used a whole pack at a time.
  - `series` string: The supplier's name of the series.

## Response `201`

Created

- ColourBarRange: Represents a supplier's series as a location keeps it at its colour bar, such as one brand's permanent colours. Belongs to a location. Holds what its items have in common: their kind, the size of a pack and its list price. Colour bar items belong to it.
  - `brand` string
  - `createdAt` string, date-time, required
  - `id` string, required: Colour bar range id.
  - `kind` string, required: What the range's items are used as, such as `colour` or `developer`. A lower-case word; the list is open.
  - `listPrice` string: The supplier's list price of one pack, VAT excluded, as a decimal string in the location's currency.
  - `locationId` string, required
  - `name` string, required: What the range is called at the location.
  - `packSize` integer: Grams in one pack of the range's items. Left out for a range whose items are used a whole pack at a time.
  - `series` string: The supplier's name of the series.
  - `updatedAt` string, date-time, required: When the range itself was last changed.

## Other responses

- `default`: Any failure. See the Errors section.

---

[API](https://skmtc.dev/cliento/apis/cliento-api.md) · [All operations](https://skmtc.dev/cliento/apis/cliento-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliento/apis/cliento-api/revisions/29ca811bc061?raw)