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

# List User Memories

> List all memories for a specific member (admin)

Returns all memories for a specific member within the organization, ordered by most recently updated first.

<Note>
  This endpoint requires admin privileges. To manage your own memories, use the [self-service User Memories API](/api-reference/user-memories/list-user-memories).
</Note>

<ParamField header="Authorization" type="string" required>
  Bearer token obtained from the authenticate endpoint. The authenticated user must be an admin.
</ParamField>

<ParamField query="member_id" type="string" required>
  ID of the member whose memories to list.
</ParamField>

## Response

<ResponseField name="user_memories" type="array">
  List of memory objects for the specified member.

  <Expandable title="Memory object">
    <ResponseField name="id" type="string">
      Unique memory ID (UUID).
    </ResponseField>

    <ResponseField name="organization_id" type="string">
      Organization this memory belongs to.
    </ResponseField>

    <ResponseField name="member_id" type="string">
      Member this memory belongs to.
    </ResponseField>

    <ResponseField name="content" type="string">
      The memory content.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the memory was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp when the memory was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X GET "https://api.trellis.sh/v1/admin/user-memories?member_id=member_01HX..." \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  response = requests.get(
      "https://api.trellis.sh/v1/admin/user-memories",
      headers={"Authorization": "Bearer YOUR_TOKEN"},
      params={"member_id": "member_01HX..."},
  )

  memories = response.json()["user_memories"]
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const memberId = "member_01HX...";

  const response = await fetch(
    `https://api.trellis.sh/v1/admin/user-memories?member_id=${memberId}`,
    {
      headers: { Authorization: "Bearer YOUR_TOKEN" },
    }
  );

  const { user_memories } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "user_memories": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "organization_id": "org_01HX...",
        "member_id": "member_01HX...",
        "content": "Prefers responses in bullet points",
        "created_at": "2025-03-01T10:00:00+00:00",
        "updated_at": "2025-03-15T14:30:00+00:00"
      }
    ]
  }
  ```

  ```json 401 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "detail": "Missing Authorization header"
  }
  ```

  ```json 403 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "detail": "Admin privileges required"
  }
  ```
</ResponseExample>
