> ## 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.

# Search Spaces

> Semantic search over project 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.**

## Body Parameters

<ParamField body="query" type="string" required>
  The natural language search query (e.g., a topic, name, or description).
</ParamField>

<ParamField body="limit" type="number" default="10">
  Maximum number of spaces to return. Maximum `50`.
</ParamField>

## Response

Returns an array of result objects ordered by similarity:

```json theme={null}
[
  {
    "similarity": 0.89,
    "record": { ...Space object... }
  }
]
```

## Error Responses

<AccordionGroup>
  <Accordion title="Plan Required — 403">
    ```json theme={null}
    { "error": "Semantic search requires a paid plan", "code": "project/plan-required" }
    ```
  </Accordion>
</AccordionGroup>