---
title: "Read accumulated agent memories/insights for this organization"
method: POST
path: "/api/v1/read_agent_memories"
tags: ["Agents"]
---

# Read accumulated agent memories/insights for this organization

`POST /api/v1/read_agent_memories`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/read_agent_memories`
- Auth: HTTP bearer

Read accumulated agent memories/insights for this organization. Memories contain patterns, anomalies, and learnings from previous analyses. Sin agent_slug devuelve las memorias de TODOS los agentes de la cuenta: usá agent_slug cuando busques lo que aprendió uno en particular, y "shared" para lo transversal (baseline del cliente, resultados destilados, preferencias).

## Request body

- object
  - `agent_slug` string: Filter by agent slug (e.g. "ads-analyst"). Omitir = todas las de la cuenta. "shared" = memorias transversales.
  - `memory_type` 'insight' | 'fact' | 'preference' | 'pattern' | 'warning' | 'living_doc': Filtrar por tipo (insight | fact | preference | pattern | warning | living_doc)
  - `path_prefix` string: Filter by memory path prefix (e.g. "meta/campaigns/")
  - `min_importance` number: Minimum importance level (1-10)
  - `limit` number

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pymaia/apis/pymaia-api.md) · [All operations](https://skmtc.dev/pymaia/apis/pymaia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pymaia/apis/pymaia-api/revisions/705a6973177b?raw)