Skip to main content
PATCH
Update product family

Authorizations

X-API-Key
string
header
required

Path Parameters

family_id
string<shortuuid>
required

Id of the product family.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Body

application/json

Payload for PATCH /families/{family_id}. Only the keys present are applied.

name
string | null

Display name for the family concept.

Required string length: 1 - 255
Pattern: ^[^\x00]{1,255}$
brand
string | null

Brand name as display text.

Maximum string length: 255
Pattern: ^[^\x00]{0,255}$
description
string | null

Family-level description.

Pattern: ^[^\x00]{0,}$
external_ref
string | null

Caller-supplied id from the source system, unique within the organization. 409 if taken.

Maximum string length: 255
Pattern: ^[^\x00]{0,255}$

Response

OK

A product family with its members in display order.

id
string<shortuuid>
required

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
organization_id
string<shortuuid>
required

The organization that owns this family.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
name
string
required

Display name for the family concept, e.g. Oatly Oat Milk.

brand
string
required

Brand name as display text. Empty string when unset.

description
string
required

Family-level description. Empty string when unset.

external_ref
string
required

Caller-supplied id from the source system (e.g. sephora:P123456), unique within the organization. Empty string when unset.

members
ProductFamilyMemberOut · object[]
required

The family's variants, in display order.

created
string<date-time>
required

Server-side ISO 8601 timestamp of creation (UTC).

modified
string<date-time>
required

Server-side ISO 8601 timestamp of last modification (UTC).