Migrate content management to v5

Upgrade document retrieval, resource lists, and document or memory deletion

Migration details

v5 retrieves, lists, and removes content within one explicit namespace.

Retrieve a document and its derived context

Legacy

GET /v3/documents/{id}
GET /v3/documents/{id}/chunks

Pass include as a comma-separated list to return chunks, memories, or both. Keys you omit are absent; requested keys with no results are empty arrays. Lifecycle fields move under system:

{"system":{"status":"done","createdAt":"...","updatedAt":"..."}}

List documents, chunks, or memories

Legacy

POST /v3/documents/list
POST /v4/memories/list

Set type to documents, chunks, or memories. Pagination and sorting move to the query string; the body contains only optional filter.

Every response contains documents, chunks, memories, and pagination. Only the selected resource array is populated. Replace legacy memories assumptions in document-list callers with documents.

Delete documents

Legacy

DELETE /v3/documents/{id}
DELETE /v3/documents/bulk

The v5 array accepts 1–100 Supermemory or caller-defined IDs. Inspect both deletedCount and per-ID errors; HTTP success can include partial failures.

Forget memories

Legacy intent	v5 operation
Forget exact IDs	DELETE /ns/{namespace}/memories with { "ids": [...] }
Find memories by meaning	DELETE /ns/{namespace}/memories/semantic with { "query": "...", "dryRun": true }

Both return { count, matches, errors }. For drift-free semantic deletion, preview with dryRun: true, review the IDs, then submit them to the exact-ID endpoint.

See memory forgetting for the complete dry-run, approval, response, and audit workflow.

Verification

• Assert requested empty includes are [], while omitted includes are absent.
• Paginate each resource type until currentPage >= totalPages; unselected arrays stay empty.
• Verify chunk rows contain their parent documentId.
• Exercise partial document-delete failures and semantic dry runs.
• Verify IDs cannot read, list, or delete content outside their namespace.