RevoEngine Documentation

POST

/

api

/

v1

/

agents

/

memory

Create Agent memory

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/memory \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kind": "fact",
  "name": "Billing source",
  "summary": "The billing reconciliation workspace uses Stripe as the payment source of truth."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    kind: 'fact',
    name: 'Billing source',
    summary: 'The billing reconciliation workspace uses Stripe as the payment source of truth.'
  })
};

fetch('https://api.revoengine.com/api/v1/agents/memory', 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/memory"

payload = {
    "kind": "fact",
    "name": "Billing source",
    "summary": "The billing reconciliation workspace uses Stripe as the payment source of truth."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

Authorizations

Authorization

string

header

required

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

Body

application/json

kind

enum<string>

required

Durable memory kind.

Available options:

preference,

fact,

episode

Example:

"fact"

name

string

required

Short stable memory name for labels and ref tokens.

Required string length: 1 - 64

Example:

"Billing source"

summary

string

required

Canonical memory body. Keep this concise and durable; it is not transcript archival.

Minimum string length: 1

Example:

"The billing reconciliation workspace uses Stripe as the payment source of truth."

ownerType

enum<string>

default:AGENT

Memory owner. WORKSPACE is bound to an agent workspace root, INSTANCE is tenant-local, and SHARED is instance-wide shared recall.

Available options:

USER,

AGENT,

WORKSPACE,

INSTANCE,

SHARED

Example:

"AGENT"

ownerId

string<uuid>

Owner id. Required for USER, AGENT, and WORKSPACE memory; ignored for INSTANCE and SHARED.

Example:

"11111111-1111-4111-8111-111111111111"

refTokens

string[]

Explicit additional exact source or resource tokens that support the memory. The API also extracts REFTYPE/id [blocked] tokens from summary.

Example:

[
  "[COMPONENTS/11111111-1111-4111-8111-111111111111](InvoiceSync)"
]

tags

string[]

Compact topical tags used for recall.

Example:

["billing", "stripe"]

Response

201 - undefined

Last modified on September 5, 2026

Create Agent memory

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/memory \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kind": "fact",
  "name": "Billing source",
  "summary": "The billing reconciliation workspace uses Stripe as the payment source of truth."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    kind: 'fact',
    name: 'Billing source',
    summary: 'The billing reconciliation workspace uses Stripe as the payment source of truth.'
  })
};

fetch('https://api.revoengine.com/api/v1/agents/memory', 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/memory"

payload = {
    "kind": "fact",
    "name": "Billing source",
    "summary": "The billing reconciliation workspace uses Stripe as the payment source of truth."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)