v1

latestOpenAPI 3.0.32026-07-17485661.9 KB

Create a space

Creates a new Ghost space. Requires user authentication (JWT). API keys cannot be used to create spaces. When no name is provided, the space is named after its owner (e.g. "Jane Doe's space").

post/spaces

Request body

namestring

Name for the new space. When omitted, the space is named after its owner (e.g. "Jane Doe's space").

Response

Space created

idstring required

Space ID.

namestring required

Space name.

role'owner' | 'admin' | 'developer' | 'viewer'

A member's role within a space. The owner role belongs to the user who created the space; every space has exactly one owner, so owner is never accepted as an input when granting a role. On the Space schema, this is the caller's own role in the space, omitted for API-key authentication (API keys are space-scoped and carry no member identity).