Sign in

v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-044334120.9 KB
Sessions & Agents
Memory Operations

Remember

Store a memory (Session-based)

Requires:

  • X-Session-Token: {session_token}

The session must be for the specified agent_id.

Provenance types:

  • explicit_statement: Directly stated by user
  • inferred: Derived from behavior/context
  • observed: Seen in action
  • validated: Confirmed/verified
  • corrected: Updated after contradiction
  • imported: From external source
post/api/v2/agents/{agent_id}/remember

Path parameters

agent_idstring required

Headers

x-session-tokenstring nullable
X-Api-Keystring nullable

Cookies

memanto_session_tokenstring nullable

Request body

contentstring required

Memory content

type'fact' | 'preference' | 'goal' | 'decision' | 'artifact' | 'learning' | 'event' | 'instruction' | 'relationship' | 'context' | 'observation' | 'commitment' | 'error' nullable

Memory type. Omit to auto-parse.

titlestring nullable

Memory title (defaults to truncated content)

confidencenumber

Confidence score (0-1)

tagsstring[] nullable

Tags for this memory

sourcestring

Who wrote this memory — 'user', 'agent', or a specific writer such as 'cursor', 'codex', or 'claude_code'.

provenancestring

How memory was obtained (explicit_statement, inferred, observed, etc.)

Response

Successful Response

memory_idstring required
agent_idstring required
session_idstring required
namespacestring required
statusstring required
provenancestring required
confidencenumber required
typestring nullable