> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# memory_add

> Save one memory. Saving the same id again updates it.

> [!NOTE]
>
> Free · Your key and project keys

Saves text into the person's Memory, filed under your tool's folder (or your project). Every search finds it, from any AI tool they connect. It is not a note: it only shows in their Library if they add it there.

> [!NOTE]
>
> Refused on a read-only sign-in. When the person's storage is full it says so and saves nothing. See [Limits](/dev/docs/guides/limits.md).

Call it at `POST /platform/v1/me/tools/memory_add` or, for one of your app's users, `POST /platform/v1/users/{uid}/tools/memory_add`. On MCP, your AI tool calls `memory_add` with the same arguments.

## Arguments

Send these inside `arguments`.

**text** `string` *required*

What to remember, in full sentences that make sense on their own. Up to 100,000 characters.

**title** `string` (default: "")

A short title, up to 300 characters. Leave it out and the first line is used.

**id** `string` (default: "")

Your own id for this memory: 1-128 letters, digits and `. _ : @ -`. Save the same id again to replace it, so one memory stays up to date. Leave it out and a new id is made and returned.

**tags** `string[]` (default: null)

Plain tag names, up to 20 of 60 characters.

## Returns

The tool's answer comes back under `result`.

**id** `string`

The memory's id. Keep it to update or forget the memory later.

**app** `string`

The folder it was filed under, like `agents`, `claudecode` or `app` + your project id.

**updated** `boolean`

`true` when a memory with this id was replaced.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/memory_add \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "X-Constella-Client: my-script" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"text": "We ship on Fridays.", "id": "team:ship-day"}}'
```

```bash Project key theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/tools/memory_add \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"text": "We ship on Fridays.", "id": "team:ship-day"}}'
```

```python Python theme={"system"}
import os, requests

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/memory_add",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"text": "We ship on Fridays.", "id": "team:ship-day"}},
)
print(r.json()["result"])
```

```javascript JavaScript theme={"system"}
const res = await fetch("https://api.constella.app/platform/v1/me/tools/memory_add", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CONSTELLA_API_KEY}`,
    "X-Constella-Client": "my-script",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"arguments": {"text": "We ship on Fridays.", "id": "team:ship-day"}}),
});
const { result } = await res.json();
```

```json 200 theme={"system"}
{
  "result": {
    "id": "team:ship-day",
    "app": "agents",
    "updated": false
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.