---
title: "Create memory via socket"
method: POST
path: "/api/v1/socket-access/{binding_token}/memories"
tags: ["sockets", "socket-access"]
---

# Create memory via socket

`POST /api/v1/socket-access/{binding_token}/memories`

Create a new memory using socket access token

## Path parameters

- `binding_token` string, required

## Headers

- `authorization` string, required

## Request body

- MemoryCreate — Model for creating a new memory.
  - `content` string, required — Memory content text
  - `tags` string[], nullable — Tags for categorizing the memory
  - `source` string, nullable — Source of the memory
  - `importance` integer, nullable — Importance score (1-10)
  - `category` string, nullable — Memory category within space
  - `metadata` object, nullable — Additional metadata
  - `space_id` string, nullable — Space ID to create memory in

## Response `201`

Successful Response

- Memory — Full memory model including system fields.
  - `content` string, required — Memory content text
  - `tags` string[], nullable — Tags for categorizing the memory
  - `source` string, nullable — Source of the memory
  - `importance` integer, nullable — Importance score (1-10)
  - `category` string, nullable — Memory category within space
  - `metadata` object, nullable — Additional metadata
  - `id` string, required — Unique identifier
  - `created_at` string, date-time, required — Creation timestamp
  - `updated_at` string, date-time, nullable — Last update timestamp
  - `created_by_user` string, required — User who created this memory
  - `space_id` string, nullable — Space this memory belongs to
  - `space_name` string, nullable — Name of the space
  - `tenant_id` string, nullable — Legacy tenant identifier
  - `full_content` string, nullable — Complete original content (internal use)
  - `is_chunk` boolean — Whether this memory is a chunk of larger content
  - `parent_memory_id` string, nullable — ID of parent memory if this is a chunk
  - `chunk_index` integer, nullable — Index of this chunk within parent memory
  - `total_chunks` integer, nullable — Total number of chunks in parent memory
  - `chunk_metadata` object, nullable — Chunk-specific metadata

## Other responses

- `403` — Access denied
- `404` — Socket not found
- `422` — Validation Error
- `500` — Internal server error

---

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