---
title: "Windowed memory usefulness analytics: retrieval volume, per-arm breakdown, citation rate per source, posterior movement"
method: GET
path: "/api/memory/usefulness"
tags: ["Memory"]
---

# Windowed memory usefulness analytics: retrieval volume, per-arm breakdown, citation rate per source, posterior movement

`GET /api/memory/usefulness`

## Query parameters

- `days` integer — Analysis window in days (default 30)
- `threshold` number, nullable — Posterior-mean threshold for the aboveThreshold count (default 0.6)

## Response `200`

Usefulness stats for the window

## Other responses

- `400` — Validation error

## Changes

- **2026-07-06** `2c8021c48f65` — 1 info
  - endpoint added
- **2026-07-02** `0c910612f9ac` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/memory/usefulness/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/4f62e32be8ec?raw)