---
title: "Semantic search in namespace"
method: GET
path: "/v1/memory/{namespace}/search"
tags: ["S5 Agent Memory"]
---

# Semantic search in namespace

`GET /v1/memory/{namespace}/search`

## Request

- Base URL: `https://api.brainiall.com`
- URL: `https://api.brainiall.com/v1/memory/{namespace}/search`
- Auth: HTTP bearer

## Path parameters

- `namespace` string, required

## Query parameters

- `q` string, required
- `k` integer

## Response `200`

Top-k hits

- MemorySearchResponse
  - `namespace` string
  - `query` string
  - `results` MemorySearchHit[]
    - `id` integer
    - `text` string
    - `score` number, float: Cosine similarity (0-1, higher is more similar)
    - `created_at` number, float: Unix timestamp when added
    - `metadata` object
  - `tier` string
  - `model` string

---

[API](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis.md) · [All operations](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis/revisions/e44fed29a7b5?raw)