---
title: "List or semantically search memories across all agents (debug/admin)"
method: POST
path: "/api/memory/list"
tags: ["Memory"]
---

# List or semantically search memories across all agents (debug/admin)

`POST /api/memory/list`

## Request body

- object
  - `query` string — Natural-language query. If present, runs semantic search; otherwise lists by recency.
  - `agentId` string — Filter to a single agent. Omit for all.
  - `scope` 'agent' | 'swarm' | 'all'
  - `source` 'manual' | 'file_index' | 'session_summary' | 'task_completion'
  - `sourcePath` string — Substring match against sourcePath (case-insensitive). Useful for file_index memories.
  - `limit` integer
  - `offset` integer

## Response `200`

Memory list / search results

- object
  - `results` object[], required
    - `id` string, required
    - `name` string, required
    - `content` string, required
    - `agentId` string, nullable, required
    - `scope` 'agent' | 'swarm', required
    - `source` 'manual' | 'file_index' | 'session_summary' | 'task_completion', required
    - `similarity` number
    - `rawSimilarity` number
    - `compositeScore` number
    - `retrievalSource` 'vec' | 'fts' | 'hybrid' | 'fallback' | 'graph'
    - `createdAt` string, required
    - `accessedAt` string, required
    - `accessCount` number, required
    - `expiresAt` string, nullable, required
    - `embeddingModel` string, nullable, required
    - `sourceTaskId` string, nullable, required
    - `sourcePath` string, nullable, required
    - `chunkIndex` number, required
    - `totalChunks` number, required
    - `tags` string[], required
  - `total` number, required
  - `limit` number, required
  - `offset` number, required
  - `mode` 'semantic' | 'list', required

## Other responses

- `400` — Validation error

---

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