---
title: "Expand a list of memory IDs into full objects."
method: POST
path: "/v1/memories/expand"
tags: ["Memories"]
---

# Expand a list of memory IDs into full objects.

`POST /v1/memories/expand`

## Request body

- object — Expand a list of memory IDs into full objects.
  - `agent_id` string — Optional agent identifier. Silently dropped if empty / non-string.
  - `memory_ids` string[], required — Required. memory_ids.
  - `user_id` string, required — Required. user_id.
  - `visibility` 'agent_only' | 'restricted' | 'workspace' — Visibility (one of agent_only / restricted / workspace). Invalid values silently drop to undefined.
  - `workspace_id` string — Optional workspace identifier. Silently dropped if empty / non-string.

## Response `200`

Expanded memories array.

- object — Expanded memory rows for the requested IDs.
  - `memories` object[], required
    - `access_count` number, required
    - `agent_id` string, nullable
    - `content` string, required
    - `created_at` string, required
    - `deleted_at` string, nullable
    - `embedding` number[], required
    - `episode_id` string, nullable
    - `expired_at` string, nullable
    - `id` string, required
    - `importance` number, required
    - `keywords` string, required
    - `last_accessed_at` string, required
    - `memory_type` string, required
    - `metadata` object, required
    - `namespace` string, nullable
    - `network` unknown
    - `observation_subject` string, nullable
    - `observed_at` string, required
    - `opinion_confidence` number, nullable
    - `overview` string, required
    - `source_site` string, required
    - `source_url` string, required
    - `status` 'active' | 'needs_clarification', required
    - `summary` string, required
    - `trust_score` number, required
    - `user_id` string, required
    - `visibility` 'agent_only' | 'restricted' | 'workspace' | 'null', nullable
    - `workspace_id` string, nullable

## Other responses

- `400` — Input validation error
- `500` — Internal server error
- `502` — Upstream AI provider returned an unrecoverable failure (auth, non-retryable 4xx).
- `503` — Upstream AI provider is rate-limited, quota-exhausted, or returned 5xx; consult `retryable`.

---

[API](https://skmtc.dev/atomicstrata/apis/atomicmemory-http-api.md) · [All operations](https://skmtc.dev/atomicstrata/apis/atomicmemory-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atomicstrata/atomicmemory-http-api/revisions/d501daa39bb2/schema)