v1

latestOpenAPI 3.0.32026-07-17485661.9 KB

List spaces

Returns Ghost spaces accessible to the authenticated user. For user JWTs, returns all Ghost spaces the user is a member of. For API keys, returns the single space the key is scoped to.

get/spaces

Response

List of spaces

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).