Pages

List sites

Required scope: pages:read

A site groups pages into ONE website with shared, platform-injected navigation. List existing sites before creating one to avoid duplicates.

Authorization

bearerAuth

AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

`application/json`

{}

Create a site, then pass its id as site_id on every POST /pages call that belongs to the same website. Required when building a multi-page website/funnel — pages created without site_id are standalone and not linked together. Idempotent by title: an existing same-title site is returned instead of duplicated. The first page attached becomes the site's home page.

Authorization

bearerAuth

AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

Site/brand name

description?string

nav_layout?string

logo_url?string

Response Body

`application/json`

{}

List pages

Required scope: pages:read

Authorization

bearerAuth

AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Response Body

`application/json`

{}

Create a page

Required scope: pages:write

Pass layout_html (a complete HTML document) to build an AI-designed page in one call. Any embedded form/booking page must be a real Space resource — references that don't resolve in this space are rejected.

Building a multi-page website? Create a site first (POST /sites) and pass site_id on every page so they form one linked website — omit site_id only for an intentionally standalone page.

Enforced: creating a 2nd+ standalone page within a short window is rejected with an error — multiple related pages must share a site. Pass standalone: true to confirm a page is an intentional one-off.