> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyke.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Spaces
> Create and manage spaces, navigate hierarchies, and look up spaces by slug or short ID
The `spaces` module covers core space lifecycle management: creating spaces, fetching them by various identifiers, updating settings, navigating parent-child hierarchies, and checking slug availability.
For membership management see [Space Members](/v7/node-sdk/spaces-members), and for moderation, rules, and digest configuration see [Space Moderation](/v7/node-sdk/spaces-moderation).
***
### createSpace
Creates a new space.
```typescript theme={null}
const space = await replyke.spaces.createSpace({
userId: "usr_abc123",
name: "Photography",
slug: "photography",
description: "A community for photographers",
postingPermission: "members",
});
```
The Replyke user ID of the space creator, who becomes the initial admin.
Display name for the space.
URL-friendly identifier. Must be unique within the project. Generated from `name` if omitted.
Short description of the space.
Who can read content: `"anyone"` (default) or `"members"`.
Who can post content: `"anyone"`, `"members"` (default), or `"admins"`.
When `true`, join requests must be manually approved. Defaults to `false`.
Makes this space a child of the specified parent space.
Arbitrary metadata attached to the space.
**Returns** — `Promise`
***
### fetchSpace
Fetches a space by its Replyke ID, including member counts and permission details.
```typescript theme={null}
const space = await replyke.spaces.fetchSpace({ spaceId: "spc_abc123" });
```
The Replyke space ID.
**Returns** — `Promise`
***
### fetchManySpaces
Fetches a paginated list of top-level spaces, with optional text search.
```typescript theme={null}
const { data, metadata } = await replyke.spaces.fetchManySpaces({
page: 1,
limit: 20,
query: "photo",
});
```
Page number (1-indexed). Defaults to `1`.
Results per page. Defaults to `20`.
When provided, fetches children of this space instead of top-level spaces.
Text search query to filter spaces by name.
**Returns** — `Promise>`
***
### fetchSpaceBySlug
Fetches a space by its unique slug.
```typescript theme={null}
const space = await replyke.spaces.fetchSpaceBySlug({ slug: "photography" });
```
The space's URL slug.
**Returns** — `Promise`
***
### fetchSpaceByShortId
Fetches a space by its short, human-readable ID (used in share URLs).
```typescript theme={null}
const space = await replyke.spaces.fetchSpaceByShortId({ shortId: "ph3x9" });
```
The space's short ID.
**Returns** — `Promise`
***
### fetchUserSpaces
Fetches the spaces a specific user is a member of.
```typescript theme={null}
const result = await replyke.spaces.fetchUserSpaces({
userId: "usr_abc123",
page: 1,
limit: 20,
});
```
The Replyke user ID.
Page number (1-indexed). Defaults to `1`.
Results per page. Defaults to `20`.
**Returns** — `Promise`
***
### updateSpace
Updates settings on an existing space.
```typescript theme={null}
const space = await replyke.spaces.updateSpace({
spaceId: "spc_abc123",
name: "Photography Community",
postingPermission: "admins",
requireJoinApproval: true,
});
```
The Replyke space ID to update.
New display name.
New slug. Must be unique.
New description.
Updated reading permission: `"anyone"` or `"members"`.
Updated posting permission: `"anyone"`, `"members"`, or `"admins"`.
Updated join approval requirement.
Updated metadata. Merged with existing values.
**Returns** — `Promise`
***
### deleteSpace
Permanently deletes a space and all its content.
```typescript theme={null}
const result = await replyke.spaces.deleteSpace({ spaceId: "spc_abc123" });
```
The Replyke space ID to delete.
**Returns** — `Promise`
***
### checkSlugAvailability
Checks whether a slug is available for use.
```typescript theme={null}
const { available } = await replyke.spaces.checkSlugAvailability({
slug: "photography",
});
```
The slug to check.
**Returns** — `Promise<{ available: boolean }>`
***
### fetchChildSpaces
Fetches the direct child spaces of a given parent space.
```typescript theme={null}
const { data, metadata } = await replyke.spaces.fetchChildSpaces({
spaceId: "spc_abc123",
page: 1,
limit: 20,
});
```
The parent Replyke space ID.
Page number (1-indexed). Defaults to `1`.
Results per page. Defaults to `20`.
**Returns** — `Promise>`
***
### fetchSpaceBreadcrumb
Returns the full ancestor chain from the root down to the specified space. Useful for rendering breadcrumb navigation.
```typescript theme={null}
const breadcrumb = await replyke.spaces.fetchSpaceBreadcrumb({
spaceId: "spc_abc123",
});
// [{ id: "root", name: "Root" }, { id: "spc_parent", name: "Parent" }, { id: "spc_abc123", name: "Photography" }]
```
The Replyke space ID to get the breadcrumb for.
**Returns** — `Promise`