---
title: "Write a memory"
method: POST
path: "/v1/memory"
tags: ["Memories"]
---

# Write a memory

`POST /v1/memory`

## Request

- Base URL: `https://api.chainmemory.ai`
- URL: `https://api.chainmemory.ai/v1/memory`
- Auth: API key in header `x-api-key`

Writes a plaintext memory. The content is encrypted server-side with a key derived from your API key. Fee: 0.001 AIC. Maximum 19936 bytes of UTF-8 text (a single on-chain transaction); larger writes are rejected with 413 and no charge. The `event_hash` is computed when the memory is synced to the chain (~30 s later), not at write time — see the note on evidence in Project Brain.

## Request body

- object
  - `summary` string, required: The memory text
  - `category` string: Free-form, e.g. DECISION, INTERACTION, CUSTOM
  - `importance` integer: 1-10, default 5
  - `platform` string: claude, chatgpt, gemini...
  - `project` string: Project slug; stored as the first tag
  - `tags` string[]: Up to 10 tags

## Response `200`

Memory written

## Other responses

- `402`: insufficient_aic
- `413`: memory_too_large — the text would not fit in a single on-chain transaction, so it could never be anchored or cited as evidence. Checked before charging, so nothing is charged (since 2026-09-16)

---

[API](https://skmtc.dev/chainmemory/apis/chainmemory-api.md) · [All operations](https://skmtc.dev/chainmemory/apis/chainmemory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chainmemory/apis/chainmemory-api/revisions/5331e0f0b6af?raw)