---
title: "Add memory"
method: POST
path: "/memory/v1"
tags: ["Memory"]
---

# Add memory

`POST /memory/v1`

Store memories from conversation messages. Automatically extracts facts and handles deduplication.

Use tag_1 through tag_12 for filtering - these are generic indexed fields you can use for any purpose:
- Legal app: tag_1=client_id, tag_2=matter_id
- Healthcare: tag_1=patient_id, tag_2=encounter_id
- E-commerce: tag_1=customer_id, tag_2=order_id

## Request body

- object
  - `messages` object[], required — Conversation messages to extract memories from
    - `role` 'user' | 'assistant' | 'system', required — Message role
    - `content` string, required — Message content
  - `tag_1` string — Generic indexed filter field 1 (you decide what it means)
  - `tag_2` string — Generic indexed filter field 2
  - `tag_3` string — Generic indexed filter field 3
  - `tag_4` string — Generic indexed filter field 4
  - `tag_5` string — Generic indexed filter field 5
  - `tag_6` string — Generic indexed filter field 6
  - `tag_7` string — Generic indexed filter field 7
  - `tag_8` string — Generic indexed filter field 8
  - `tag_9` string — Generic indexed filter field 9
  - `tag_10` string — Generic indexed filter field 10
  - `tag_11` string — Generic indexed filter field 11
  - `tag_12` string — Generic indexed filter field 12
  - `category` string — Custom category (e.g., "fact", "preference", "deadline")
  - `metadata` object — Additional metadata (not indexed)
  - `infer` boolean — Whether to extract facts from messages (default: true)
  - `extraction_prompt` string — Optional custom prompt for fact extraction

## Response `200`

Memories added successfully

- object
  - `results` object[]
    - `id` string — Memory ID
    - `memory` string — Extracted memory text
    - `event` 'ADD' | 'UPDATE' | 'DELETE' | 'NONE' — What happened to this memory

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid API key
- `403` — API key does not have access to Memory service
- `500` — Memory service error

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)