Update Agent Memory

Beta

PATCH/v1/ai/memories/{id}

Idempotent with Idempotency-Key header. Learn more

Updates an agent memory.

Only the fields included in the request are changed; everything else keeps its current value.

Permissions requiredValues:agent_memories:update

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

idstring

Memory ID.

categoryoptional string

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.

contentoptional string

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

metadataoptional objectnullable

Arbitrary metadata as JSON.

Replaces the stored metadata outright rather than merging into it.

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

entity_typeoptional stringnullable

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; send null (on either entity field) to unscope the memory. Send null to clear.

entity_idoptional stringnullable

ID of the platform record this memory is scoped to.

Provide together with entity_type; send null to unscope the memory. Send null to clear.

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.

expires_atoptional stringnullable

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. Send null so the memory is used indefinitely. Send null to clear.

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

200

Successful response for Update Agent Memory

Update 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.update('agmm_o7tjkr16gfmh', {
  content: 'Customer prefers next-day shipping on all orders.',
  importance: 0.9,
});

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.update('agmm_o7tjkr16gfmh', {
  content: 'Customer prefers next-day shipping on all orders.',
  importance: 0.9,
});

console.log(agentMemory.id);

200 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"
}

Update Agent Memory

Authorization

Path Parameters

Request Body

Returns

Responses