---
title: "Store a memory"
method: POST
path: "/api/v1/agent/memories"
tags: ["agentApiMemories"]
---

# Store a memory

`POST /api/v1/agent/memories`

Stores a new memory entry. The memory will be:
- Associated with the authenticated agent as the source
- Scoped to the subject (for cross-agent sharing) or organization (for shared knowledge)

For subject-scoped memories, provide a `subject_id` to associate the memory with a specific user or agent.
For organization-scoped memories, omit `subject_id` - the memory will be visible to all agents in the org.

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `memory` AgentMemoryCreateRequest, required — Request to create a new memory
    - `content` string, required — The memory content
    - `metadata` AgentMemoryCreateRequestMetadata — Additional metadata (tags, references, etc.)
      - `references` string[] — Related memory IDs
      - `tags` string[] — Tags for categorization
    - `scope` 'subject' | 'organization' — Visibility: subject (cross-agent, about this subject) or organization (all agents)
    - `segment` 'user' | 'agent' | 'tool' | 'guideline', required — Logical segment
    - `subject_id` string, uuid — UUID of the subject this memory is about. Required for subject scope.
    - `system` 'sensory' | 'working' | 'long_term', required — Memory system tier
    - `thought` string, required — Agent's reasoning for storing this memory
    - `type` 'iconic' | 'echoic' | 'haptic' | 'episodic' | 'semantic' | 'procedural', required — Memory type (must be valid for selected system)

## Response `201`

Created Memory

- MemoriesCreateAgentMemoryResponse201 — unresolved $ref

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.dev/band/apis/request-api.md) · [All operations](https://skmtc.dev/band/apis/request-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/band/request-api/revisions/6cdae3febf9d/schema)