Mem0

Create an export job with schema

Initiates an asynchronous job to export memories, structured by a schema provided in the request body and allowing optional filters.

Create memory entry

Lists/searches existing memory entries with filtering and pagination; critically, this action retrieves memories and does *not* create new ones, despite its name.

Create project

Creates a new project with a given name within an organization that must already exist.

Delete an organization

Permanently deletes an existing organization identified by its unique id.

Delete a specific memory by id

Permanently deletes a specific memory by its unique id; ensure the `memory id` exists as this operation is irreversible.

Delete entity by type and id

Call to permanently and irreversibly hard-delete an existing entity (user, agent, app, or run) and all its associated data, using its type and id.

Delete memories endpoint

Deletes memories matching specified filter criteria; omitting all filters may result in deleting all memories.

Delete memory batch with uuids

Deletes a batch of up to 1000 existing memories, identified by their uuids, in a single api call.

Delete project

Permanently deletes a specific project and all its associated data from an organization; this action cannot be undone and requires the project to exist within the specified organization.

Delete project member

Removes an existing member, specified by username, from a project, immediately revoking their project-specific access; the user is not removed from the organization.

Export data based on filters

Retrieves memory export data, optionally filtered by various identifiers (e.g., user id); without filters, it may return all accessible or recent exports based on default behavior.

Fetch detailed list of organizations

Retrieves a summary list of organizations for administrative oversight; returns summary data (names, ids), not exhaustive details, despite 'detailed' in the name.

Fetch details of a specific organization

Fetches comprehensive details for an organization using its `org id`; the `org id` must be valid and for an existing organization.

Fetch list of entity filters

Retrieves predefined filter definitions for entities (e.g., by type, creation/modification date); returns definitions only, not filtered entity data.

Fetch specific entity details with optional filters

Fetches detailed information for an existing entity (user, agent, app, or run) identified by its type and unique id.

Get organization members

Fetches a list of members for a specified, existing organization.

Get project details

Fetches comprehensive details for a specified project within an organization.

Get project members

Retrieves all members for a specified project within an organization.

Get projects

Retrieves all projects for a given organization `org id` to which the caller has access.

Get user memory stats

Retrieves a summary of the authenticated user's memory activity, including total memories created, search events, and add events.

List entities with optional org and project filters

Retrieves a list of entities, optionally filtered by organization or project (prefer `org id`/`project id` over deprecated `org name`/`project name`), noting results may be summaries and subject to…

Perform semantic search on memories

Searches memories semantically using a natural language query (required if `only metadata based search` is false) and/or metadata filters.

Remove a member from the organization

Removes a member, specified by their username, from an existing organization of which they are currently a member.

Retrieve all events for the currently logged in user

Retrieves a paginated list of events for the authenticated user, filterable and paginable via url query parameters.

Retrieve entity specific memories

Retrieves all memories (e.g., user preferences, chat history) for a specific entity from the mem0 platform, using its `entity type` and `entity id`; ensure the entity exists.

Retrieve list of memory events

Retrieves a chronological list of all memory events (e.g., user inputs, ai responses) from the mem0 platform, providing interaction history and context for ai assistants.

Retrieve memory by unique identifier

Retrieves a complete memory entry by its unique identifier; `memory id` must be valid and for an existing memory.

Retrieve memory history by id

Retrieves the complete version history for an existing memory, using its unique `memory id`, to inspect its evolution or audit changes.

Retrieve memory list

Retrieves a list of memories, supporting pagination and diverse filtering (e.g., by ids, metadata, keywords, date ranges); ensure dates are iso 8601 and `page`/`page size` (if used) are positive…

Search memories with query filters

Semantically searches memories using a natural language query and mandatory structured filters, offering options to rerank results and select specific fields; any provided `org id` or `project id`…

Update memory batch with uuid

Updates text for up to 1000 memories in a single batch, using their uuids.

Update memory details by id

Updates the text content of an existing memory, identified by its `memory id`.

Update organization member role

Updates the role of an existing member to a new valid role within an existing organization.

Update project

Updates a project by `project id` within an `org id`, modifying only provided fields (name, description, custom instructions, custom categories); list fields are fully replaced (cleared by `[]`)…

Update project member role

Updates the role of a specific member within a designated project, ensuring the new role is valid and recognized by the system.