Get Space by ID

Retrieve a single space by its unique ID.

Overview

Fetches a specific space by its spaceId. Useful for loading space details when navigating directly to a space.

Endpoint

GET /api/spaces/:spaceId

Requires authentication. Include a Bearer token in the Authorization header.

Request

Path parameters

spaceId · string · required

The unique ID of the space to retrieve.

Response

Returns a single Space object.

space_id · string

Unique identifier for the space.

title · string

Display title of the space.

description · string

Short description of the space.

visibility · string

Visibility of the space: "public" or "private".

creator · object

The user who created the space.

Show creator properties

user_id · string

Unique identifier of the creator.

username · string

Username of the creator.

profile_picture · string

URL of the creator’s profile picture.

participant_count · number

Number of participants currently in the space.

tags · array

Tags associated with the space.

Show tag properties

tag_id · number

Unique identifier of the tag.

tag_name · string

Display name of the tag.

Example

TypeScript

import { getSpaceById } from "./api/Spaces";

const space = await getSpaceById("abc123");

console.log(space);
// {
//   space_id: "abc123",
//   title: "Morning Standup",
//   description: "Daily sync for remote teams",
//   visibility: "public",
//   creator: { user_id: "u1", username: "alice", profile_picture: "https://..." },
//   participant_count: 42,
//   tags: [{ tag_id: 1, tag_name: "work" }]
// }