---
title: "List memories for current user"
method: GET
path: "/api/v1/me/memories"
tags: ["humanApiMemories"]
---

# List memories for current user

`GET /api/v1/me/memories`

Lists memories accessible to the authenticated user:
- Memories about the user (subject_id = user's UUID)
- Organization-scoped memories in the user's organization
- The `agent`-scoped private memories of the agents this user owns, which
  carry no organization and so come back with `organization_id: null`
- Optionally filter by chat room to see room-level memories

Unlike agents, users can see memories from ALL agents in their organization
that are about them or in rooms they participate in. Another owner's agents'
private memories are never returned.

**Pagination:** Use `cursor` + `limit` (recommended) OR `page` + `page_size` (deprecated, sunset 2026-10-01).
Do NOT mix families.

**Display fields:** each row carries `subject_name`, `subject_type`,
`source_agent_name`, `chat_room_title`, `chat_room_status` and
`chat_room_type` next to the raw ids, so a table can be labelled without a
follow-up request per row. They are resolved once for the whole page. Every
one of them is nullable: a referent that was deleted, or that the caller may
not see, reads as null while its id is still returned.

## Query parameters

- `cursor` string
- `limit` integer
- `page` integer
- `chat_room_id` string
- `scope` string
- `system` string
- `type` string
- `segment` string
- `source_agent_id` string, uuid
- `content_query` string
- `page_size` integer
- `status` string

## Headers

- `X-API-Key` string, required

## Response `200`

User Memories

- MemoriesListUserMemoriesResponse200 — unresolved $ref

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Invalid pagination params (invalid/unsupported cursor, or mixed cursor + offset families)

## Changes

- **2026-08-22** `d4b03725c5d7` — 2 info
  - `query` request parameter `page` was deprecated
  - `query` request parameter `page_size` was deprecated
- **2026-08-19** `92d816f1291b` — 1 info
  - added the new optional `query` request parameter `source_agent_id`

[Change history](https://skmtc.dev/band/apis/request-api/changes/api/v1/me/memories/get.md)

---

[API](https://skmtc.dev/band/apis/request-api.md) · [All operations](https://skmtc.dev/band/apis/request-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/band/request-api/revisions/3cff423845a2/schema)