RevoEngine Documentation

PATCH

/

api

/

v1

/

agents

/

{agentId}

/

memory

/

{agentMemoryId}

Update memory for an Agent

curl --request PATCH \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/memory/{agentMemoryId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ownerType": "INSTANCE",
  "ownerId": "11111111-1111-4111-8111-111111111111",
  "kind": "preference",
  "name": "Incident RCA style",
  "summary": "Use concise incident RCAs for this workspace.",
  "refTokens": [
    "[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)"
  ],
  "tags": [
    "billing",
    "stripe"
  ],
  "version": 6
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ownerType: 'INSTANCE',
    ownerId: '11111111-1111-4111-8111-111111111111',
    kind: 'preference',
    name: 'Incident RCA style',
    summary: 'Use concise incident RCAs for this workspace.',
    refTokens: ['[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)'],
    tags: ['billing', 'stripe'],
    version: 6
  })
};

fetch('https://api.revoengine.com/api/v1/agents/{agentId}/memory/{agentMemoryId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/agents/{agentId}/memory/{agentMemoryId}"

payload = {
    "ownerType": "INSTANCE",
    "ownerId": "11111111-1111-4111-8111-111111111111",
    "kind": "preference",
    "name": "Incident RCA style",
    "summary": "Use concise incident RCAs for this workspace.",
    "refTokens": ["[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)"],
    "tags": ["billing", "stripe"],
    "version": 6
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

Authorizations

Authorization

string

header

required

Bearer JWT token or API Key (sk-*).

Path Parameters

agentId

string

required

agentMemoryId

string

required

Body

application/json

ownerType

enum<string>

Updated memory owner.

Available options:

USER,

AGENT,

WORKSPACE,

INSTANCE,

SHARED

Example:

"INSTANCE"

ownerId

string<uuid>

Updated owner id. Used for USER, AGENT, and WORKSPACE memory; null for INSTANCE and SHARED.

Example:

"11111111-1111-4111-8111-111111111111"

kind

enum<string>

Updated durable memory kind.

Available options:

preference,

fact,

episode

Example:

"preference"

name

string

Updated short stable memory name for labels and ref tokens.

Required string length: 1 - 64

Example:

"Incident RCA style"

summary

string

Updated canonical memory body.

Minimum string length: 1

Example:

"Use concise incident RCAs for this workspace."

refTokens

string[]

Replacement explicit exact source or resource tokens. The API also extracts REFTYPE/id [blocked] tokens from the current summary.

Example:

[
  "[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)"
]

tags

string[]

Replacement topical tags.

Example:

["billing", "stripe"]

version

number

Optimistic locking version.

Required range: x >= 0

Example:

6

Response

200 - undefined

Last modified on September 5, 2026

Update memory for an Agent

curl --request PATCH \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/memory/{agentMemoryId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ownerType": "INSTANCE",
  "ownerId": "11111111-1111-4111-8111-111111111111",
  "kind": "preference",
  "name": "Incident RCA style",
  "summary": "Use concise incident RCAs for this workspace.",
  "refTokens": [
    "[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)"
  ],
  "tags": [
    "billing",
    "stripe"
  ],
  "version": 6
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ownerType: 'INSTANCE',
    ownerId: '11111111-1111-4111-8111-111111111111',
    kind: 'preference',
    name: 'Incident RCA style',
    summary: 'Use concise incident RCAs for this workspace.',
    refTokens: ['[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)'],
    tags: ['billing', 'stripe'],
    version: 6
  })
};

fetch('https://api.revoengine.com/api/v1/agents/{agentId}/memory/{agentMemoryId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/agents/{agentId}/memory/{agentMemoryId}"

payload = {
    "ownerType": "INSTANCE",
    "ownerId": "11111111-1111-4111-8111-111111111111",
    "kind": "preference",
    "name": "Incident RCA style",
    "summary": "Use concise incident RCAs for this workspace.",
    "refTokens": ["[COMPONENTS/77777777-7777-4777-8777-777777777777](BillingSync)"],
    "tags": ["billing", "stripe"],
    "version": 6
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)