Create uom-values

POST /uom-values. Required scopes: uom-values:write.

POST /api/public/v1/uom-values

Create uom-values

cURL

curl --request POST \
  --url https://wisepim.com/api/public/v1/uom-values \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "name": "<string>",
  "symbol": "<string>",
  "code_set": 123
}
'

201

{
  "code": "<string>",
  "name": "<string>",
  "symbol": "<string>",
  "localized_names": "<unknown>",
  "localized_symbols": "<unknown>",
  "conversion_factor": "<string>",
  "is_base_unit": true,
  "sort_order": 123,
  "code_set": 123,
  "id": 123
}

Authorizations

Authorization · string · header · required

Use a project API key from Settings > API Access. Send it as Authorization: Bearer wpk_.... See authentication and scopes for setup and permissions.

Headers

Idempotency-Key · string

Reuse this key for retries of the same write. Scoped to this API key; retained until key deletion. Different requests with the same key return 409.

Required string length: 1 - 128

Pattern: ^[!-~]+$

Body

application/json

code · string · required

Unit code (e.g., 'mm', 'cm', 'in')

Maximum string length: 20

name · string · required

Default name of the unit (e.g., 'Millimeter', 'Centimeter')

Maximum string length: 100

symbol · string · required

Display symbol (e.g., 'mm', 'cm', '"')

Maximum string length: 10

code_set · integer · required

The UOM set this unit belongs to

localized_names · Localized Names · object

Localized unit names keyed by locale code (e.g., {'en': 'Inch', 'nl': 'Duim'})

Show child attributes

localized_symbols · Localized Symbols · object

Localized symbols keyed by locale code (e.g., {'en': 'in', 'de': 'Zoll'})

Show child attributes

conversion_factor · number string

Conversion factor relative to base unit. Value in this unit * factor = value in base unit

is_base_unit · boolean

Whether this is the base unit (conversion_factor should be 1.0)

sort_order · integer

Display order within the code set

Response

201

application/json

Created

code · string · required

Unit code (e.g., 'mm', 'cm', 'in')

Maximum string length: 20

name · string · required

Default name of the unit (e.g., 'Millimeter', 'Centimeter')

Maximum string length: 100

symbol · string · required

Display symbol (e.g., 'mm', 'cm', '"')

Maximum string length: 10

localized_names · any · required

Localized unit names keyed by locale code (e.g., {'en': 'Inch', 'nl': 'Duim'})

localized_symbols · any · required

Localized symbols keyed by locale code (e.g., {'en': 'in', 'de': 'Zoll'})

conversion_factor · string · required

Conversion factor relative to base unit. Value in this unit * factor = value in base unit

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$

is_base_unit · boolean · required

Whether this is the base unit (conversion_factor should be 1.0)

sort_order · integer · required

Display order within the code set

code_set · integer · required

The UOM set this unit belongs to

id · integer · required