Blog
Required scope: pages:read
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Response Body
application/json
{}Required scope: pages:write
Create a blog — the real blog system, not a static page. Pass site_id
(from POST /sites) to make it part of one website. The collection holds
the post layout (template_html with {{title}} {{cover_image}}
{{excerpt}} {{body}} {{author}} {{date}} tokens; a neutral default
is used if omitted) — reused for every post. Idempotent by base_slug per
space. Then add posts with POST /blog/posts.
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
{}Required scope: pages:write
The base_slug is fixed at creation. Pass null for site_id/index_page_id to detach.
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
{}Required scope: pages:read
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Query Parameters
Response Body
application/json
{}Required scope: pages:write
Add a post to a collection. Provide body_html (rendered into the blog
template), plus optional excerpt, cover_image_url, author. Defaults
to a draft; pass status: published to publish immediately (live at
/post/<id>).
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
{}Required scope: pages:write
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
{}Required scope: pages:run
Publishes the post live at /post/. Pass publish=false to move it back to draft.
Authorization
bearerAuth A Space API key, e.g. wks_live_….
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
{}