Skip to main content

​
Overview

EverMemOS Cloud provides a set of APIs for building agents with persistent memory:
  • Add memories from messages and interactions
  • Retrieve stored memories with filtering options
  • Search memories using hybrid retrieval
  • Delete memories when needed
  • Set / update conversation metadata to improve extraction and retrieval behavior

​
Base URL

All endpoints are served from: https://api.evermind.ai Most routes use the /api/v1 prefix (for example: /api/v1/memories).

​
Authentication

All endpoints are authenticated using a Bearer token. Send your API key in the Authorization header: 
Authorization: Bearer YOUR_API_KEY
Never expose or commit your API key.

​
Available endpoints

Add Memories

POST /api/v1/memories — extract and store memories from messages and interactions.

Get Memories

GET /api/v1/memories — retrieve memories with filters (e.g., by metadata fields).

Search Memories

GET /api/v1/memories/search — keyword-driven hybrid retrieval (BM25 + vector search).

Delete Memories

DELETE /api/v1/memories — delete memories based on request parameters.

Set Conversation Metadata

POST /api/v1/memories/conversation-meta — set metadata for a conversation.

Update Conversation Metadata

PATCH /api/v1/memories/conversation-meta — update metadata for a conversation.