---
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
    - `metadata` object, nullable, required — Arbitrary key-value metadata attached to this memory, or null if none was provided

## Other responses

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

---

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