---
title: "Add Memory"
method: POST
path: "/api/v2/memory/add"
tags: ["memory"]
---

# Add Memory

`POST /api/v2/memory/add`

Add messages into the user-memory + agent-memory pipelines.

## Request body

- MemorizeAddRequest
  - `session_id` string, required
  - `app_id` string
  - `project_id` string
  - `messages` MessageItemDTO[], required
    - `sender_id` string, required
    - `sender_name` string, nullable
    - `role` 'user' | 'assistant' | 'tool', required
    - `timestamp` integer, required — Message event time as Unix epoch in **milliseconds** (v1 API contract; the algo layer auto-detects sec vs ms for backward compat but the contract is ms).
    - `content` union, required
      - string
      - ContentItemDTO[]
        - `type` 'text' | 'image' | 'audio' | 'doc' | 'pdf' | 'html' | 'email', required
        - `text` string, nullable
        - `uri` string, nullable
        - `base64` string, nullable
        - `ext` string, nullable
        - `name` string, nullable
        - `extras` object, nullable
    - `tool_calls` ToolCallDTO[], nullable
      - `id` string, required
      - `type` string
      - `function` ToolFunctionDTO, required
        - `name` string, required
        - `arguments` string, required
    - `tool_call_id` string, nullable
  - `defer_extraction` boolean — Persist messages in the durable unprocessed buffer without running boundary detection or extraction. A later /flush commits the batch.

## Response `200`

Successful Response

- SuccessEnvelopeAddResponseData
  - `request_id` string, required
  - `data` AddResponseData, required
    - `message_count` integer, required
    - `status` 'accumulated' | 'extracted', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-17** `9a2e78d664d6` — 1 info
  - added the new optional request property `defer_extraction`
- **2026-07-24** `305b14a16dcd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/evermind-ai/apis/everos/changes/api/v2/memory/add/post.md)

---

[API](https://skmtc.dev/evermind-ai/apis/everos.md) · [All operations](https://skmtc.dev/evermind-ai/apis/everos/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evermind-ai/everos/revisions/9a2e78d664d6/schema)