Skip to main content
PATCH
Change a page

Authorizations

Authorization
string
header
required

A member credential in the Authorization: Bearer header: a member session JWT, a portal JWT whose login is linked to a membership in that company, an opaque member token, or a verified One Auth identity access token. The credential alone identifies the member and company. Member session and portal JWTs are read-only and are refused with 403 on every write.

Path Parameters

site_id
string<uuid>
required

Public id of one of the member's sites.

page_id
string<uuid>
required

Public id of one of the site's pages.

Body

application/json

Changes to a page. Send at least one field besides lock_version. Fields a member cannot set are refused as unknown fields.

slug
string
required

Lowercase letters and digits separated by single hyphens, unique in the site, or / for the home page. The page keeps its public id, and its content moves with it.

Required string length: 1 - 255
Pattern: ^(/|[a-z0-9]+(-[a-z0-9]+)*)$
title
string

Display title.

Required string length: 1 - 255
Pattern: ^[^\u0000]*[^\s\u0000][^\u0000]*$
position
integer

Order of the page among the site's pages.

published
boolean

Whether the page is shown once the site is published.

layout_name
string | null

The layout this page uses. Null uses the site's default.

Maximum string length: 255
menu
string | null

The slug of one of the site's own menus. A menu of another site is refused. Null removes the page's menu.

Maximum string length: 255
content
string

The page's new content. Refused with 403 for a page that uses a template the site does not own.

Pattern: ^[^\u0000]*$
lock_version
integer

The lock_version the caller last read. The change is refused with 409 if the page changed since.

Required range: 0 <= x <= 2147483647

Response

The changed page.

One page.

status
integer
required

HTTP status code (mirrors the response status line).

data
object
required

One page of a site. Its content is the site file pages/<slug>.liquid, not part of the page.

meta
object
required

Envelope metadata present on every response.