Spaces are containers for your documentation or knowledge base content. Use this API to create new spaces, manage existing ones, and delete or archive spaces you no longer need.
The Space object
Attributes
objectstring · enumRequired
Type of Object, always equals to "space"
Possible values:
idstringRequired
Unique identifier for the space
titlestring · max: 50Required
Title of the space
emojistring · emoji · max: 50Required
An emoji for this space. It'll match the emoji shown in the GitBook app.
Example: 🎉
visibilitystring · enumRequired
public: Anyone can access the content, and the content is indexed by search engines.
unlisted: Anyone can access the content, and the content is not indexed by search engines
share-link: Anyone with a secret token in the url can access the content.
visitor-auth: Anyone authenticated through a JWT token can access the content.
in-collection: Anyone who can access the parent collection can access the content.
Only available for spaces in a collection.
private: Authorized members can access the content.
Possible values:
createdAtstring · date-timeRequired
updatedAtstring · date-timeRequired
deletedAtstring · date-timeOptional
editModestring · enumOptional
Determines how a Space can be edited.
live: Users can directly edit the space
locked: All edits are locked for this space.
Possible values:
organizationstringRequired
ID of the organization owning this space
parentstringOptional
ID of the parent collection.
visitorAuthone ofOptional
or
all ofOptional
revisionstringRequired
ID of the active revision in the space.
defaultLevelone ofRequired
Default level for a piece of content
string · enum | nullableOptional
"The role of a member in an organization.
"admin": Can administrate the content: create, delete spaces, ...
"create": Can create content.
"review": Can review content.
"edit": Can edit the content (live or change requests).
"comment": Can access the content and its discussions.
"read": Can access the content, but cannot update it in any way.