Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Body

application/json
id
string
required

Caller-supplied axis id (must be unique).

Minimum string length: 1
name
string
required

Display name of the axis (e.g. Couleur, Famille).

Minimum string length: 1
scope
enum<string>
required

What the axis classifies: product, variant (builds SKU-group labels), or movement.

Available options:
product,
variant,
movement
source
enum<string>
required

Origin of the axis values: managed, local, or an external feed.

Available options:
managed,
local
roots
any[]

The initial node tree (unbounded depth); defaults to empty.

valueType
enum<string>

How the axis is typed / rendered: text (default) / color / size / etc.

Available options:
text,
color,
size,
number,
measure
unit
string

Unit shared by measure nodes (cm, ml, …).

Minimum string length: 1
multiValued
boolean

Whether a product may hold several values on this axis.

Response

The created axis.

The created axis.

id
string
required
Minimum string length: 1
name
string
required
Minimum string length: 1
scope
enum<string>
required
Available options:
product,
variant,
movement
source
enum<string>
required
Available options:
managed,
local
roots
any[]
required
version
integer
required
Required range: 0 < x <= 9007199254740991
valueType
enum<string>
Available options:
text,
color,
size,
number,
measure
unit
string
Minimum string length: 1
multiValued
boolean
active
boolean