Recollections API
Recollections are collections of memories that can be associated with neurons for context and knowledge retrieval.
List Recollections
Get a list of recollections.
Brain scope required. Include the X-Brain-Id header or configure getBrainId in the public client.
| Header | Type | Description |
|---|
X-Brain-Id | string (UUID) | Required. Brain ID for scoping |
Query Parameters
| Parameter | Type | Description |
|---|
limit | number | Maximum number of results (default: 20) |
offset | number | Offset for pagination |
Get Recollection
Get a single recollection by ID.
GET /v1/recollections/:id
Path Parameters
| Parameter | Type | Description |
|---|
id | string | Recollection UUID |
Get Recollection Stats
Get memory count, chunk count, and grep_cortex document count for a recollection (RAG scope exploration).
GET /v1/recollections/:id/stats
Path Parameters
| Parameter | Type | Description |
|---|
id | string | Recollection UUID |
Response
| Field | Type | Description |
|---|
memory_count | number | Number of memories in the recollection |
chunk_count | number | Total chunks across those memories |
grep_doc_count | number | Documents in grep_cortex for keyword search |
Search Recollections
Search within recollections by owner. Supports semantic (vector), keyword (fulltext), or hybrid strategy.
Brain scope required. Include the X-Brain-Id header or brain_id in the request body.
POST /v1/recollections/search
| Header | Type | Description |
|---|
X-Brain-Id | string (UUID) | Required. Brain ID for scoping |
Request Body
| Field | Type | Required | Description |
|---|
query | string | Yes | Search query |
owner_type | string | Yes | Owner type (e.g. neuron, trace) |
owner_ids | string[] | Yes | Owner UUIDs to scope search |
limit | number | No | Max results (default: 10, max: 100) |
threshold | number | No | Score threshold for vector strategy (default: 0.7) |
strategy | string | No | qdrant (default), fulltext, or hybrid. fulltext uses keyword search (grep_cortex); hybrid merges vector and keyword with RRF. |
context | string | No | Filter recollections by context (project or context metadata). |
neuron_id | string | No | Filter recollections by neuron UUID. |
project | string | No | Filter recollections by project metadata. |
trace_id | string | No | Scope search to a trace’s recollection (owner_type= trace when owner_ids empty). |
tags | string[] | No | Filter recollections by tags (must match all). |
Create Recollection
Create a new recollection.
Request Body
| Field | Type | Required | Description |
|---|
name | string | Yes | Recollection name |
description | string | No | Recollection description |
Update Recollection
Update an existing recollection.
PUT /v1/recollections/:id
Delete Recollection
Delete a recollection.
DELETE /v1/recollections/:id
- Neurons API - Use recollections in neuron configurations
- Memories API - Add memories to recollections
- Grep - Search memories, artifacts, resources