Mem0

Learn how to use Mem0 with Composio

Overview

Enum

MEM0

Description

Mem0

Authentication Details

api_key
stringRequired

Actions

Adds an existing user to a project (identified by `project id` within organization `org id`), assigning a valid system role.

Action Parameters

org_id
stringRequired
project_id
stringRequired
role
stringRequired
username
stringRequired

Action Response

data
object
error
successful
boolean
Stores new memory records from a list of messages, optionally inferring structured content; requires association via `agent id`, `user id`, `app id`, or `run id`.

Action Parameters

agent_id
string
app_id
string
excludes
string
includes
string
infer
booleanDefaults to True
messages
arrayRequired
org_id
string
org_name
string
output_format
string
project_id
string
project_name
string
run_id
string
user_id
string

Action Response

data
object
error
successful
boolean
Adds a new member, who must be a registered user, to an organization, assigning them a specific role.

Action Parameters

email
stringRequired
org_id
stringRequired
role
stringRequired

Action Response

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

Action Parameters

app_id
string
org_id
string
project_id
string
run_id
string
session_id
string
user_id
string

Action Response

data
object
error
successful
boolean
Creates a new agent with a unique `agent id` and an optional `name`; additional metadata may be assigned by the system.

Action Parameters

agent_id
stringRequired
name
string

Action Response

data
object
error
successful
boolean
Creates a new agent run in the mem0.ai system.

Action Parameters

name
string
run_id
stringRequired

Action Response

data
object
error
successful
boolean
Creates a new application, allowing metadata to be passed in the request body (not an explicit field in this action's request model); ensure `app id` is unique to avoid potential errors or unintended updates.

Action Parameters

app_id
stringRequired
name
string

Action Response

data
object
error
successful
boolean
Creates a new organization entry using the provided name and returns its details.

Action Parameters

name
stringRequired

Action Response

data
object
error
successful
boolean
Creates a new user with the specified unique `user id` and supports associating `metadata` (not part of the request schema fields).

Action Parameters

user_id
stringRequired

Action Response

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

Action Parameters

filters
object
org_id
string
org_name
string
page
integer
page_size
integer
project_id
string
project_name
string

Action Response

data
object
error
successful
boolean
Creates a new project with a given name within an organization that must already exist.

Action Parameters

name
stringRequired
org_id
stringRequired

Action Response

data
object
error
successful
boolean
Permanently deletes an existing organization identified by its unique id.

Action Parameters

org_id
stringRequired

Action Response

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

Action Parameters

memory_id
stringRequired

Action Response

data
object
error
successful
boolean
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.

Action Parameters

entity_id
stringRequired
entity_type
stringRequired

Action Response

data
object
error
successful
boolean
Deletes memories matching specified filter criteria; omitting all filters may result in deleting all memories.

Action Parameters

agent_id
string
app_id
string
metadata
object
org_id
string
org_name
string
project_id
string
project_name
string
run_id
string
user_id
string

Action Response

data
object
error
successful
boolean
Deletes a batch of up to 1000 existing memories, identified by their uuids, in a single api call.

Action Parameters

memory_ids
arrayRequired

Action Response

data
object
error
successful
boolean
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.

Action Parameters

org_id
stringRequired
project_id
stringRequired

Action Response

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

Action Parameters

org_id
stringRequired
project_id
stringRequired
username
stringRequired

Action Response

data
object
error
successful
boolean
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.

Action Parameters

app_id
string
org_id
string
project_id
string
run_id
string
session_id
string
user_id
string

Action Response

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

Action Parameters

Action Response

data
object
error
successful
boolean
Fetches comprehensive details for an organization using its `org id`; the `org id` must be valid and for an existing organization.

Action Parameters

org_id
stringRequired

Action Response

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

Action Parameters

Action Response

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

Action Parameters

entity_id
stringRequired
entity_type
stringRequired

Action Response

data
object
error
successful
boolean
Fetches a list of members for a specified, existing organization.

Action Parameters

org_id
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves all projects for a given organization `org id` to which the caller has access.

Action Parameters

org_id
stringRequired

Action Response

data
object
error
successful
boolean
Fetches comprehensive details for a specified project within an organization.

Action Parameters

org_id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves all members for a specified project within an organization.

Action Parameters

org_id
stringRequired
project_id
stringRequired

Action Response

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

Action Parameters

Action Response

data
object
error
successful
boolean
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 limits.

Action Parameters

org_id
string
org_name
string
project_id
string
project_name
string

Action Response

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

Action Parameters

agent_id
string
app_id
string
categories
array
fields
array
filter_memories
boolean
only_metadata_based_search
boolean
org_id
string
org_name
string
output_format
string
project_id
string
project_name
string
query
stringRequired
rerank
boolean
run_id
string
top_k
integerDefaults to 10
user_id
string

Action Response

data
object
error
successful
boolean
Removes a member, specified by their username, from an existing organization of which they are currently a member.

Action Parameters

org_id
stringRequired
username
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves a paginated list of events for the authenticated user, filterable and paginable via url query parameters. this is a read-only operation that does not modify data. supported query parameters (applied directly to the request url): - `event type` (str, optional): filters events by their type (e.g., 'add', 'search'). - `start date` (str, optional): filters events on or after this date (format: yyyy-mm-dd). - `end date` (str, optional): filters events on or before this date (format: yyyy-mm-dd). - `page` (int, optional): specifies the page number for paginated results. - `page size` (int, optional): number of events per page (default: 50, max: 100).

Action Parameters

Action Response

data
object
error
successful
boolean
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.

Action Parameters

entity_id
stringRequired
entity_type
stringRequired

Action Response

data
object
error
successful
boolean
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.

Action Parameters

Action Response

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

Action Parameters

memory_id
stringRequired

Action Response

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

Action Parameters

memory_id
stringRequired

Action Response

data
object
error
successful
boolean
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 integers.

Action Parameters

agent_id
string
app_id
string
categories
array
end_date
string
fields
array
keywords
string
metadata
object
org_id
string
org_name
string
page
integer
page_size
integer
project_id
string
project_name
string
run_id
string
start_date
string
user_id
string

Action Response

data
object
error
successful
boolean
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` must reference a valid existing entity.

Action Parameters

fields
array
filters
objectRequired
org_id
string
org_name
string
project_id
string
project_name
string
query
stringRequired
rerank
boolean
top_k
integerDefaults to 10

Action Response

data
object
error
successful
boolean
Updates text for up to 1000 memories in a single batch, using their uuids.

Action Parameters

memories
arrayRequired

Action Response

data
object
error
successful
boolean
Updates the text content of an existing memory, identified by its `memory id`.

Action Parameters

memory_id
stringRequired
text
string

Action Response

data
object
error
successful
boolean
Updates the role of an existing member to a new valid role within an existing organization.

Action Parameters

org_id
stringRequired
role
stringRequired
username
stringRequired

Action Response

data
object
error
successful
boolean
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 `[]`), other omitted/null fields remain unchanged.

Action Parameters

custom_categories
array
custom_instructions
array
description
string
name
string
org_id
stringRequired
project_id
stringRequired

Action Response

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

Action Parameters

org_id
stringRequired
project_id
stringRequired
role
stringRequired
username
stringRequired

Action Response

data
object
error
successful
boolean