Memory API

Add Memories

Extract and store memories from conversations.

POST /v1/memories

Request Body

Field	Type	Required	Description
messages	array	Yes	Conversation messages
user_id	string	No	User identifier
agent_id	string	No	Agent identifier
infer	boolean	No	Extract facts (default: true)
extract_graph	boolean	No	Extract entities (default: false)
metadata	object	No	Custom key-value pairs

Example

curl -X POST https://api.memoid.dev/v1/memories 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "messages": [
      {"role": "user", "content": "I love hiking"},
      {"role": "assistant", "content": "Great hobby!"}
    ],
    "user_id": "user_123"
  }'

Response

{
  "results": [
    {
      "id": "mem_abc123",
      "memory": "User loves hiking",
      "event": "ADD"
    }
  ]
}

---

List Memories

Retrieve memories with optional filters.

GET /v1/memories

Query Parameters

Parameter	Type	Default	Description
user_id	string	-	Filter by user
agent_id	string	-	Filter by agent
limit	int	100	Maximum results
offset	int	0	Pagination offset

Example

curl "https://api.memoid.dev/v1/memories?user_id=user_123&limit=10" 
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "results": [
    {
      "id": "mem_abc123",
      "memory": "User loves hiking",
      "user_id": "user_123",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1
}

---

Get Memory

Retrieve a specific memory by ID.

GET /v1/memories/:id

Example

curl "https://api.memoid.dev/v1/memories/mem_abc123" 
  -H "Authorization: Bearer YOUR_API_KEY"

---

Update Memory

Update a memory’s content or metadata.

PUT /v1/memories/:id

Request Body

Field	Type	Description
memory	string	New memory text
metadata	object	Updated metadata

---

Delete Memory

Delete a specific memory.

DELETE /v1/memories/:id

Example

curl -X DELETE "https://api.memoid.dev/v1/memories/mem_abc123" 
  -H "Authorization: Bearer YOUR_API_KEY"

---

Delete All Memories

Delete memories matching filters.

DELETE /v1/memories

Query Parameters

Parameter	Type	Description
user_id	string	Delete all for user
agent_id	string	Delete all for agent

Example

curl -X DELETE "https://api.memoid.dev/v1/memories?user_id=user_123" 
  -H "Authorization: Bearer YOUR_API_KEY"

---

Memory History

Get change history for a memory.

GET /v1/memories/:id/history

Response

{
  "history": [
    {
      "memory": "User works at Google",
      "changed_at": "2024-01-15T10:30:00Z",
      "event": "UPDATE"
    },
    {
      "memory": "User works at startup",
      "changed_at": "2024-01-10T09:00:00Z",
      "event": "ADD"
    }
  ]
}