---
title: "Create AI memory entry"
method: POST
path: "/v1/ai/memory"
tags: ["AI Memory"]
---

# Create AI memory entry

`POST /v1/ai/memory`

Create a memory entry. Environment entries require the "manage AI memory" system access right, user entries can be created for the caller's own user ID, object entries require modify access to the object. Title must be unique within scope.

## Request body

- AiMemoryEntryConfig
  - `scope` 'environment' | 'user' | 'object', required — Entry scope
  - `scopeId` integer — User ID for user scope (defaults to caller), object ID for object scope
  - `title` string, required — Entry title (unique within scope, max 127 bytes)
  - `content` string, required — Entry content (limited by the configured per-scope size)
  - `locked` boolean — Lock the entry against changes by the model

## Response `201`

Entry created

- AiMemoryEntry
  - `id` integer — Unique entry identifier
  - `scope` 'environment' | 'user' | 'object' — Entry scope
  - `scopeId` integer — User ID for user scope, object ID for object scope, 0 for environment scope
  - `title` string — Entry title (unique within scope)
  - `content` string — Entry content
  - `createdBy` 'model' | 'human' — Who created the entry
  - `sourceUserId` integer — ID of the user on whose behalf the entry was created
  - `sourceType` 'chat' | 'task' | 'operator' | 'human' — Execution context that created the entry
  - `sourceId` integer — Chat ID, AI task ID, or AI operator instance ID depending on source type (0 for human)
  - `createdAt` integer — Creation time (UNIX timestamp)
  - `updatedAt` integer — Last modification time (UNIX timestamp)
  - `locked` boolean — True if the entry cannot be changed or deleted by the model

## Other responses

- `400` — Invalid request
- `403` — Insufficient access rights
- `409` — Entry with this title already exists in the scope

## Changes

- **2026-10-01** `b4fc7bfd5bd3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/ai/memory/post.md)

---

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