Create Agent Memory

Beta

POST/v1/ai/memories

Idempotent with Idempotency-Key header. Learn more

Saves a piece of information for agents to recall on future runs.

Permissions requiredValues:agent_memories:create

The role behind your API key or agent must grant every one of these permissions.

categorystring

The kind of information this memory holds, used to group related memories.

preference: how someone likes things done, such as a customer who always wants express shipping.
fact: a durable detail worth remembering about the account or one of its records, such as a customer's typical order size.
instruction: standing guidance for agents to follow, such as always confirming freight before issuing an order.

contentstring

The information to remember, written as plain text for an agent to read.

metadataoptional objectnullable

Arbitrary metadata as JSON.

Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string. Send null to clear.

entity_typeoptional string

Type of platform record this memory is scoped to (e.g. customer, product).

Provide together with entity_id to scope the memory to a specific record; omit both for a memory that is not tied to any particular record.

entity_idoptional string

ID of the platform record this memory is scoped to.

Provide together with entity_type.

importanceoptional number

Relative importance from 0 to 1 in increments of 0.1, used to prioritize which memories the agent recalls.

An agent takes in only a limited number of memories per run and recalls the highest-importance ones first, so a memory created without an importance is stored at 0 and is the first to be left out.

expires_atoptional string

When this memory should stop being used, as an ISO 8601 timestamp (e.g. 2026-01-02T15:04:05Z).

Past this time the memory is no longer recalled by agents and is omitted from list results, but it is not deleted. Omit it for a memory that should be used indefinitely.

idstring

Memory ID.

objectstringenumValues:agent_memory

Resource type identifier.

categorystring

The kind of information this memory holds, used to group related memories.

preference: how someone likes things done, such as a customer who always wants express shipping.
fact: a durable detail worth remembering about the account or one of its records, such as a customer's typical order size.
instruction: standing guidance for agents to follow, such as always confirming freight before issuing an order.

contentstring

The information itself, written as plain text for an agent to read.

metadataobjectnullable

Arbitrary metadata as JSON.

Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

entityentitynullable

The platform record this memory is about (e.g. a specific customer or product).

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

importancenumber

Relative importance from 0 to 1, used to prioritize which memories the agent recalls.

An agent takes in only a limited number of memories per run, and the highest-importance ones are recalled first.

expires_atstring (date-time)nullable

When this memory stops being used.

Past this time the memory is no longer recalled by agents and is omitted from list results, but it is not deleted and can still be retrieved by ID. A memory with no expiration is used indefinitely.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

201

Successful response for Create Agent Memory

Create Agent Memory

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const agentMemory = await client.ai.memories.create({
  category: 'preference',
  content: 'Customer prefers express shipping on all orders.',
  importance: 0.8,
  metadata: { source: 'support_ticket' },
});

console.log(agentMemory.id);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const agentMemory = await client.ai.memories.create({
  category: 'preference',
  content: 'Customer prefers express shipping on all orders.',
  importance: 0.8,
  metadata: { source: 'support_ticket' },
});

console.log(agentMemory.id);

201 example

{
  "id": "agmm_o7tjkr16gfmh",
  "object": "agent_memory",
  "category": "preference",
  "content": "Customer prefers express shipping for all orders.",
  "metadata": {},
  "entity": {
    "id": "ac_opnlh43ymyee",
    "object": "entity",
    "type": "customer",
    "name": "Acme Inc.",
    "handle": "100042"
  },
  "importance": 0.8,
  "expires_at": "2026-06-10T00:00:00Z",
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "agmm_o7tjkr16gfmh",
  "object": "agent_memory",
  "category": "preference",
  "content": "Customer prefers express shipping for all orders.",
  "metadata": {},
  "entity": {
    "id": "ac_opnlh43ymyee",
    "object": "entity",
    "type": "customer",
    "name": "Acme Inc.",
    "handle": "100042"
  },
  "importance": 0.8,
  "expires_at": "2026-06-10T00:00:00Z",
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Create Agent Memory

Authorization

Request Body

Returns

Responses