> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Chat Memories - GET /v1/workspaces/:workspace_id/chat-memories

> Return layered chat memories via GET /v1/workspaces/:workspace_id/chat-memories, filterable by layer. Minimum role viewer.

Return a workspace's layered chat memories (L0 atom / L1 scenario / L2 persona / L3 core). Filter by `layer` query parameter.

## Endpoint

```http theme={null}
GET /v1/workspaces/:workspace_id/chat-memories
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **viewer**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

## Query parameters

**layer** `integer`

Only return memories of this layer (0–3).

## Response

The response is an array; each element is a chat memory:

**id** `string`

Memory id (`cm_...`).

**workspace\_id** `string`

Owning workspace id.

**owner\_id** `string`

Owner user id.

**session\_id** `string`

Source session id.

**layer** `integer`

Layer (0 atom / 1 scenario / 2 persona / 3 core).

**kind** `string`

Kind (`fact` / `preference` / `constraint` / `event` / `scenario` / `persona`).

**content** `string`

Memory content.

**visibility** `string`

Visibility (`private` / `team` / `restricted` / `agent`).

**created\_at** `string`

Creation time (RFC3339).

## Example

```bash cURL theme={null}
curl "https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/chat-memories?layer=3" \
  -H "Authorization: Bearer <jwt>"
```

```json 200 theme={null}
[
  {
    "id": "cm_01a2b3c4d5e6",
    "workspace_id": "ws_01a2b3c4d5e6",
    "owner_id": "usr_01a2b3c4d5e6",
    "session_id": "sess_01a2b3c4d5e6",
    "layer": 3,
    "kind": "persona",
    "content": "User is a developer focused on pricing and integration.",
    "visibility": "private",
    "created_at": "2026-10-12T09:05:00Z"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.