Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/sam-shervin/space7/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Returns a list of spaces recommended for the currently authenticated user. Only public spaces are returned. Recommendations are based on the user’s activity and preferences.

Endpoint

GET /api/spaces/recommended
Requires authentication. Include a Bearer token in the Authorization header.

Request

Query parameters

limit
number
Maximum number of spaces to return. Defaults to 10.

Response

Returns an array of Space objects. Only public spaces are included.
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. Always "public" for results from this endpoint.
creator
object
The user who created the space.
participant_count
number
Number of participants currently in the space.
tags
array
Tags associated with the space.

Example

TypeScript
import { getRecommendedSpaces } from "./api/Spaces";

// Fetch the default 10 recommended spaces
const spaces = await getRecommendedSpaces();

// Fetch up to 20 recommended spaces
const moreSpaces = await getRecommendedSpaces({ limit: 20 });

console.log(spaces);
// [
//   {
//     space_id: "xyz789",
//     title: "Design Systems",
//     description: "A space for UI/UX designers",
//     visibility: "public",
//     creator: { user_id: "u2", username: "bob", profile_picture: "https://..." },
//     participant_count: 18,
//     tags: [{ tag_id: 3, tag_name: "design" }]
//   }
// ]

Build docs developers (and LLMs) love