Skip to main content
PATCH
Update a brand story page

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string<shortuuid>
required

URL-safe brand identifier.

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

Identifier of the page, as listed.

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

Body

application/json

Payload to change a story page.

name
string | null

Internal label, 1 to 120 characters, unique among the brand's pages of this kind; a name already in use is refused with 422.

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

Header brand name to show instead of the brand's own; empty to use the brand's name.

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

One-line tagline under the brand name; empty for none.

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

Header background colour, a 6-digit hex value such as #0a84ff.

Pattern: ^#[0-9A-Fa-f]{6}$
accent_color
string | null

Button and link colour, a 6-digit hex value such as #ff9500.

Pattern: ^#[0-9A-Fa-f]{6}$
blocks
Blocks · object[] | null

The full list of content blocks, replacing the current list. Types: hero_image, text_section, image_text, certification_badges, image_gallery and cta.

Response

OK

A brand-styled product story page made of ordered content blocks.

id
string<shortuuid>
required

Identifier of the page.

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

Internal label shown to brand managers when picking a page for a rule.

brand_name_override
string
required

Header brand name shown instead of the brand's own; empty to use the brand's name.

tagline
string
required

One-line tagline under the brand name; empty when none.

primary_color
string
required

Header background colour, a 6-digit hex value such as #0a84ff.

accent_color
string
required

Button and link colour, a 6-digit hex value such as #ff9500.

created
string<date-time>
required

ISO-8601 creation timestamp.

modified
string<date-time>
required

ISO-8601 last-modified timestamp.

blocks
Blocks · object[]
required

Ordered content blocks, each a {type, data} object. Types: hero_image, text_section, image_text, certification_badges, image_gallery and cta. A malformed block is refused with 422.