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

# Add a memory

`POST /v1/memories`

## Request

- Base URL: `https://innernet.live/api`
- URL: `https://innernet.live/api/v1/memories`
- Auth: HTTP bearer

Store a memory scoped to your application. Namespace it with user_id / agent_id / run_id to keep each of your end-users’ memories separate.

## Request body

- object
  - `content` string, required
  - `user_id` string: Your end-user id
  - `agent_id` string
  - `run_id` string
  - `project` string: Optional innernet project slug to associate
  - `metadata` object
  - `tags` string[]

## Response `201`

Created

- object
  - `memory` Memory
    - `id` string, uuid
    - `user_id` string, nullable: Your end-user namespace (not the innernet account)
    - `agent_id` string, nullable
    - `run_id` string, nullable
    - `project_slug` string, nullable
    - `content` string
    - `metadata` object
    - `tags` string[]
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: Error

---

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