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

## Other responses

- `400` — Validation error

## Changes

- **2026-07-28** `cf533d6b49b0` — 1 info
  - the `agentId` request property format was generalized from `uuid` to no format

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/memory/list/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/92a1dcbd2fc7/schema)