Search Spaces
Search Endpoints
Search Spaces
Semantic search over project spaces
Search Spaces
Performs vector-similarity search over spaces in the project using AI embeddings. Returns the most semantically relevant spaces for the given query.
Requires a paid plan with semantic search enabled.
Requires an authenticated user. Send the user’s access token as
Authorization: Bearer <token> — missing token → 401, invalid/expired token → 403 (refresh and retry).
Only
public spaces are returned. Spaces with visibility of "unlisted" or "private" are never surfaced in search results for non-members. Hidden spaces stay indexed but filtered out, so re-listing a space (setting it back to "public") makes it searchable again immediately with no rebuild. See Space visibility.Body Parameters
string
required
The natural language search query (e.g., a topic, name, or description).
number
default:"10"
Maximum number of spaces to return. Maximum
50.Response
Returns an array of result objects ordered by similarity:Error Responses
Authentication Required — 401 / 403
Authentication Required — 401 / 403
The endpoint requires an authenticated user. A missing token returns a bare
401; an invalid or expired token returns a bare 403 — refresh the access token and retry.Plan Required — 403
Plan Required — 403

