---
title: "One aggregate row per keyed memory under a key prefix: chunks, usage, rating, estimated tokens (debug/admin)"
method: GET
path: "/api/memory/keys"
tags: ["Memory"]
---

# One aggregate row per keyed memory under a key prefix: chunks, usage, rating, estimated tokens (debug/admin)

`GET /api/memory/keys`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/memory/keys`
- Auth: HTTP bearer

The operator key, a user, and the lead see every agent's memories. Any other agent sees only its own memories and swarm-scope memories.

## Query parameters

- `prefix` string: Literal, case-sensitive key prefix (default '/longterm/').
- `limit` integer

## Response `200`

Keyed memories grouped by (key, scope, agentId). accessCount is summed over chunk rows; rating pools alpha/beta over chunk rows; estTokens = ceil(chars / 4)

- object
  - `prefix` string, required
  - `keys` object[], required
    - `key` string, required
    - `scope` 'agent' | 'swarm', required
    - `agentId` string, nullable, required
    - `memoryId` string, required
    - `name` string, required
    - `source` 'manual' | 'file_index' | 'session_summary' | 'task_completion', required
    - `chunkRows` number, required
    - `totalChunks` number, required
    - `complete` boolean, required
    - `chars` number, required
    - `estTokens` number, required
    - `accessCount` number, required
    - `lastAccessedAt` string, nullable, required
    - `rating` number, required
    - `alpha` number, required
    - `beta` number, required
    - `usefulRatings` number, required
    - `notUsefulRatings` number, required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `truncated` boolean, required

## Other responses

- `400`: Validation error

## Changes

- **2026-10-04** `6e004b7ce47e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/memory/keys/get.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.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)