---
title: "Create memories directly"
method: POST
path: "/v4/memories"
tags: ["Content Management"]
---

# Create memories directly

`POST /v4/memories`

Create memories directly, bypassing the document ingestion workflow. Generates embeddings and makes them immediately searchable.

## Request body

- object
  - `memories` object[], required — Array of memories to create
    - `content` string, required — The memory text. Should be entity-centric, e.g. 'John prefers dark mode'.
    - `isStatic` boolean — Mark as true for permanent traits (name, profession, hometown). Defaults to false.
    - `metadata` object — Arbitrary key-value metadata to attach.
    - `forgetAfter` string, datetime, nullable — ISO 8601 datetime string. The memory will be auto-forgotten after this time. Pass null or omit for no expiry.
    - `forgetReason` string, nullable — Optional reason for the scheduled forgetting. Only meaningful when forgetAfter is set.
    - `temporalContext` object — Structured temporal metadata. Merged into the metadata JSON column.
      - `documentDate` string, datetime, nullable — Date the document was authored
      - `eventDate` string[], nullable — Dates of events referenced in the memory
  - `containerTag` string, required — The space / container tag these memories belong to.

## Response `201`

Memories created successfully

- object — Response after creating memories
  - `documentId` string, nullable, required — ID of the source document created
  - `memories` object[], required
    - `id` string, required
    - `memory` string, required
    - `isStatic` boolean, required
    - `createdAt` string, required
    - `forgetAfter` string, nullable, required — ISO datetime when this memory expires
    - `forgetReason` string, nullable, required — Reason for scheduled forgetting

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Space not found for the given containerTag
- `500` — Server error

## Changes

- **2026-04-07** `b5edd97adf4a` — 2 info
  - api tag `Content Management` added
  - api tag `Memories` removed
- **2026-03-26** `e519a815da91` — 5 info
  - added the new optional request property `memories/items/forgetAfter`
  - added the new optional request property `memories/items/forgetReason`
  - added the new optional request property `memories/items/temporalContext`
  - added the required property `memories/items/forgetAfter` to the response with the `201` status
  - …1 more
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-03-12** `7386f0fb8043` — 1 warning
  - changed the pattern of the request property `containerTag` from `^[a-zA-Z0-9_-]+$` to `^[a-zA-Z0-9_:-]+$`
- **2026-03-09** `8d6903994bad` — 1 breaking, 1 warning
  - added the pattern `^[a-zA-Z0-9_-]+$` to the request property `containerTag`
  - the `containerTag` request property's maxLength was set to `100`

[Full history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v4/memories/post.md)

---

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