Agent Memory

Persistent key-value memories and compressed session diaries for AI agents. Built for multi-agent systems that need to remember across conversations.

Overview

Agent memory lets you:

Register agents in a knowledge base
Store memories as key-value pairs with typed categories
Recall memories for an agent session
Read diaries -- AAAK-compressed session summaries

Register an agent

curl -X POST https://api.ryvion.ai/api/v1/knowledge-bases/KB_ID/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"support-bot"}'

Request body

Parameter	Type	Required	Description
`agent_name`	string	Yes	Unique name for the agent within this knowledge base

Store a memory

curl -X POST https://api.ryvion.ai/api/v1/knowledge-bases/KB_ID/agents/support-bot/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"user_preference","value":"prefers dark mode","memory_type":"fact"}'

Request body

Parameter	Type	Required	Description
`key`	string	Yes	Memory key (unique per agent)
`value`	string	Yes	Memory value
`memory_type`	string	Yes	Type category: `fact`, `preference`, `context`, etc.

Recall memories

Retrieve all memories for an agent:

curl https://api.ryvion.ai/api/v1/knowledge-bases/KB_ID/agents/support-bot/memories \
  -H "Authorization: Bearer YOUR_API_KEY"

Response format

{
  "memories": [
    {
      "key": "user_preference",
      "value": "prefers dark mode",
      "memory_type": "fact",
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z"
    }
  ]
}

Delete a memory

curl -X DELETE https://api.ryvion.ai/api/v1/knowledge-bases/KB_ID/agents/support-bot/memories/user_preference \
  -H "Authorization: Bearer YOUR_API_KEY"

Read agent diary

The diary is an AAAK-compressed session summary -- a concise record of what the agent has done across sessions.

curl https://api.ryvion.ai/api/v1/knowledge-bases/KB_ID/agents/support-bot/diary \
  -H "Authorization: Bearer YOUR_API_KEY"

Response format

{
  "diary": "Session summary: handled 12 support tickets, resolved 10. User preferences updated for 3 accounts. Escalated 2 tickets to human review.",
  "updated_at": "2026-04-08T14:30:00Z"
}

Endpoints summary

Method	Endpoint	Description
`POST`	`/api/v1/knowledge-bases/:id/agents`	Register an agent
`POST`	`/api/v1/knowledge-bases/:id/agents/:name/memories`	Store a memory
`GET`	`/api/v1/knowledge-bases/:id/agents/:name/memories`	List all memories
`DELETE`	`/api/v1/knowledge-bases/:id/agents/:name/memories/:key`	Delete a memory
`GET`	`/api/v1/knowledge-bases/:id/agents/:name/diary`	Read agent diary

Use cases

Personalization -- store user preferences across conversations
Task tracking -- remember what tasks have been completed
Multi-agent coordination -- share state between agents through a common knowledge base
Session continuity -- compressed diaries give agents context about past sessions without loading full history