---
title: "Search Memories"
method: POST
path: "/api/v1/search"
tags: ["search"]
---

# Search Memories

`POST /api/v1/search`

Search for relevant memories within a memory space using hybrid retrieval (semantic + keyword + graph + temporal), RRF fusion, cross-encoder reranking, and recency/temporal boosting.

## Request body

- SearchRequest
  - `query` string, required — The search query text
  - `space_id` string, uuid, required — The memory space to search within
  - `limit` integer — Max number of results to return
  - `recency_bias` number, nullable — Override recency weighting. 0.0 disables recency, higher values favor recent memories.
  - `rerank` boolean — Apply cross-encoder reranking. Disable for lower latency.
  - `graph` boolean — Include graph traversal signal. Disable for semantic + keyword only.
  - `diversify` boolean — Apply MMR diversity post-rerank. Enable for broad/summarization intents.
  - `include_source` boolean — Include original source text in results.

## Response `200`

Ranked memory candidates

- SearchResponse
  - `query` string, required
  - `candidates` MemoryCandidate[], required
    - `memory_id` string, uuid, required
    - `content` string, required
    - `memory_type` string, required
    - `score` number, required
    - `source` string, nullable
    - `created_at` string, required
    - `event_time` string, nullable, required
    - `owner_name` string, nullable, required

## Other responses

- `401` — Unauthorized
- `404` — Space not found
- `429` — Rate limited, quota exceeded, or too many concurrent searches
- `500` — Unexpected failure
- `504` — Search timed out

---

[API](https://skmtc.net/crosmos/apis/crosmos-api.md) · [All operations](https://skmtc.net/crosmos/apis/crosmos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crosmos/crosmos-api/versions/a828d1399648/schema)