> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mem0

> Mem0 is an universal, self-improving memory layer for LLM applications.

![Mem0 logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/mem0.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=3fd94a28d127a1277ba4a33603137928)

* **Category:** artificial intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 47
* **Triggers:** 0
* **Slug:** `MEM0`
* **Version:** 20261101\_00

## Tools

> [accordion] Add member to project
>
> **Slug:** `MEM0_ADD_MEMBER_TO_PROJECT`
>
> Adds an existing user to a project (identified by `project_id` within organization `org_id`), assigning a valid system role.
>
> #### Input Parameters
>
> **role** `string` *required*
>
> Role defining the new member's project permissions. Must be either 'OWNER' or 'READER'.
>
> **email** `string` *required*
>
> Email address of the user to add to the project.
>
> **org\_id** `string` *required*
>
> Identifier of the organization owning the project.
>
> **project\_id** `string` *required*
>
> Identifier of the project to add the member to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add new memory records
>
> **Slug:** `MEM0_ADD_NEW_MEMORY_RECORDS`
>
> Adds memory records from messages, optionally inferring structured content. Requires an agent, user, app, or run ID; processing defaults to asynchronous and can be requested synchronously.
>
> #### Input Parameters
>
> **infer** `boolean`
>
> If true, infers structured memories from messages; otherwise, stores messages directly.
>
> **app\_id** `string`
>
> Unique identifier for the application associated with this memory. At least one of agent\_id, user\_id, app\_id, or run\_id must be provided.
>
> **org\_id** `string`
>
> Optional unique identifier for the organization associated with this memory.
>
> **run\_id** `string`
>
> Unique identifier for the run associated with this memory. At least one of agent\_id, user\_id, app\_id, or run\_id must be provided.
>
> **user\_id** `string`
>
> Unique identifier for the user associated with this memory. At least one of agent\_id, user\_id, app\_id, or run\_id must be provided.
>
> **agent\_id** `string`
>
> Unique identifier for the agent associated with this memory. At least one of agent\_id, user\_id, app\_id, or run\_id must be provided.
>
> **excludes** `string`
>
> Comma-separated keywords to exclude specific topics, aiding in filtering out irrelevant information.
>
> **includes** `string`
>
> Comma-separated keywords to include specific topics, aiding filtering and prioritization.
>
> **messages** `array` *required*
>
> List of message objects forming the memory's content. Each message should have 'role' (e.g., 'user' or 'assistant') and 'content' (text content). Alternative: You can also provide 'records' with 'text' field which will be automatically converted to messages format.
>
> **org\_name** `string`
>
> The name of the organization for this memory. Deprecated: use `org_id` instead.
>
> **async\_mode** `boolean`
>
> Whether to process memories asynchronously (default: true). When true, returns event\_id/status/message for tracking background processing. When false, processes synchronously and returns id/event/memory fields. Most clients use the default async mode.
>
> **project\_id** `string`
>
> Optional unique identifier for the project associated with this memory.
>
> **project\_name** `string`
>
> The name of the project for this memory. Deprecated: use `project_id` instead.
>
> **output\_format** `string`
>
> Specifies the response output format. 'v1.1' offers enhanced detail; 'v1.0' (default) will be deprecated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add organization member
>
> **Slug:** `MEM0_ADD_ORGANIZATION_MEMBER`
>
> Adds a new member, who must be a registered user, to an organization, assigning them a specific role.
>
> #### Input Parameters
>
> **role** `string` *required*
>
> The role (should be in uppercase) to be assigned to the user within the organization (allowed values: 'OWNER' and 'READER'). This dictates the user's permissions.
>
> **email** `string` *required*
>
> The email of the user to be added to the organization.
>
> **org\_id** `string` *required*
>
> Unique identifier of the organization to which the member will be added.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new agent
>
> **Slug:** `MEM0_CREATE_A_NEW_AGENT`
>
> Creates a new agent with a unique agent ID and a required name; additional metadata may be assigned by the system.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the agent, used for display or easier identification. This field is required by the API.
>
> **agent\_id** `string` *required*
>
> Unique identifier for the agent, used for referencing in subsequent API calls.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new agent run
>
> **Slug:** `MEM0_CREATE_A_NEW_AGENT_RUN`
>
> Creates a new agent run in the mem0.ai system.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the agent run. Required by the API.
>
> **run\_id** `string` *required*
>
> Client-defined identifier for the agent run. Should be unique for distinct identification.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new application
>
> **Slug:** `MEM0_CREATE_A_NEW_APPLICATION`
>
> Creates a new application with an application ID and name; ensure the app ID is unique to avoid potential errors or unintended updates.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> A required, human-readable name for the application. The API requires this field to be provided.
>
> **app\_id** `string` *required*
>
> The unique identifier for the application to be created. This ID will be used to reference the application in subsequent API calls.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new organization entry
>
> **Slug:** `MEM0_CREATE_A_NEW_ORGANIZATION_ENTRY`
>
> Creates a new organization entry using the provided name and returns its details.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name for the new organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new user
>
> **Slug:** `MEM0_CREATE_A_NEW_USER`
>
> Creates a new user with the specified unique user ID and optional metadata.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The unique identifier for the new user. This ID will be used for future references to this user.
>
> **metadata** `object`
>
> Additional metadata to associate with the user
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create memory entry
>
> **Slug:** `MEM0_CREATE_MEMORY_ENTRY`
>
> Lists or searches existing memory entries using required nonempty filters and optional pagination. Despite its name, this action retrieves memories rather than creating them.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (1-indexed).
>
> **org\_id** `string`
>
> Unique organization ID to filter memories. Preferred over the deprecated `org_name`.
>
> **filters** `object` *required*
>
> Required filters to retrieve memories (CANNOT be empty - must specify at least one filter condition). Logical operators (`AND`, `OR`, `NOT`) must be UPPERCASE and take a list of conditions. Comparison operators must be lowercase: `in` (matches any value), `gte` (>=), `lte` (\<=), `gt` (>), `lt` (\<), `ne` (not equal), `contains`, `icontains` (case-insensitive). Use `*` as wildcard to match any value for a field. ONLY the following 8 fields are supported (no other fields like 'status', 'tags', 'metadata', 'timestamp', 'feedback', etc. are allowed): user\_id, agent\_id, app\_id, run\_id, created\_at, updated\_at, categories, keywords.
>
> **org\_name** `string`
>
> DEPRECATED: Organization name to filter memories. Use `org_id` instead for improved stability and future compatibility.
>
> **page\_size** `integer`
>
> Number of memory entries per page.
>
> **project\_id** `string`
>
> Unique project ID to filter memories. Preferred over the deprecated `project_name`.
>
> **project\_name** `string`
>
> DEPRECATED: Project name to filter memories. Use `project_id` instead for improved stability and future compatibility.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create project
>
> **Slug:** `MEM0_CREATE_PROJECT`
>
> Creates a new project with a given name within an organization that must already exist.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name to be assigned to the new project.
>
> **org\_id** `string` *required*
>
> The unique identifier of the organization under which the new project will be created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create webhook
>
> **Slug:** `MEM0_CREATE_WEBHOOK`
>
> Creates a new webhook for a specific project to receive real-time notifications. Use when you need to set up event-driven integrations that trigger on memory operations.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> URL endpoint where webhook events will be sent. Must be a valid HTTPS URL.
>
> **name** `string`
>
> Human-readable name for the webhook to help identify its purpose.
>
> **is\_active** `boolean`
>
> Whether the webhook should be active immediately after creation. Defaults to true if not specified.
>
> **project\_id** `string` *required*
>
> Unique identifier of the project to create the webhook for.
>
> **event\_types** `array`
>
> List of event types to subscribe to. If not specified, webhook will receive all event types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an organization
>
> **Slug:** `MEM0_DELETE_AN_ORGANIZATION`
>
> Permanently deletes an existing organization identified by its unique ID.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> The unique identifier of the organization that is to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete memory by id
>
> **Slug:** `MEM0_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.
>
> #### Input Parameters
>
> **memory\_id** `string` *required*
>
> The unique identifier of the memory to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete entity by type and id
>
> **Slug:** `MEM0_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.
>
> #### Input Parameters
>
> **entity\_id** `string` *required*
>
> Unique identifier (ID) of the entity for deletion. Can be an integer ID or a string identifier.
>
> **entity\_type** `string ("user" | "agent" | "app" | "run")` *required*
>
> Type of the entity to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete memories
>
> **Slug:** `MEM0_DELETE_MEMORIES_ENDPOINT`
>
> Deletes all memories matching specified filter criteria. IMPORTANT: At least one filter (agent\_id, user\_id, app\_id, or run\_id) must be provided to prevent accidental deletion of all memories. Requires delete permissions on the organization/project.
>
> #### Input Parameters
>
> **app\_id** `string`
>
> Deletes all memories associated with this app ID. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **org\_id** `string`
>
> Organization ID to scope the deletion. Preferred over org\_name.
>
> **run\_id** `string`
>
> Deletes all memories associated with this run ID. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **user\_id** `string`
>
> Deletes all memories associated with this user ID. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **agent\_id** `string`
>
> Deletes all memories associated with this agent ID. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **metadata** `object`
>
> Optional additional filter: deletes memories matching this metadata criteria.
>
> **org\_name** `string`
>
> Organization name to scope the deletion. Deprecated: use `org_id` instead.
>
> **project\_id** `string`
>
> Project ID to scope the deletion. Preferred over project\_name.
>
> **project\_name** `string`
>
> Project name to scope the deletion. Deprecated: use `project_id` instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete memory batch with uuids
>
> **Slug:** `MEM0_DELETE_MEMORY_BATCH_WITH_UUIDS`
>
> Deletes a batch of up to 1000 existing memories, identified by their UUIDs, in a single API call.
>
> #### Input Parameters
>
> **memories** `array` *required*
>
> A list of memory objects, each containing a memory\_id field with the UUID of the memory to be deleted. Maximum of 1000 memories can be deleted in a single request. Also accepts 'memory\_ids' as a simple list of UUID strings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete project
>
> **Slug:** `MEM0_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.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> The unique identifier of the organization to which the project belongs.
>
> **project\_id** `string` *required*
>
> The unique identifier of the project to be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete project member
>
> **Slug:** `MEM0_DELETE_PROJECT_MEMBER`
>
> Removes an existing member, specified by email address, from a project, immediately revoking their project-specific access; the user is not removed from the organization.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of the member to be removed from the project.
>
> **org\_id** `string` *required*
>
> Unique identifier of the organization containing the project.
>
> **project\_id** `string` *required*
>
> Unique identifier of the project from which the member will be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete webhook
>
> **Slug:** `MEM0_DELETE_WEBHOOK`
>
> Deletes a webhook and stops receiving notifications for the specified webhook ID. Use this when you no longer need webhook notifications or want to remove a specific webhook configuration.
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> Unique identifier of the webhook to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export data based on filters
>
> **Slug:** `MEM0_EXPORT_DATA_BASED_ON_FILTERS`
>
> Creates a memory export job requiring organization and project IDs and at least one user, agent, app or run filter. Returns a job ID and confirmation message; uses a default memory schema if none is specified.
>
> #### Input Parameters
>
> **app\_id** `string`
>
> Filter to export memories for a specific App ID. At least one of user\_id, agent\_id, app\_id, or run\_id must be provided.
>
> **org\_id** `string` *required*
>
> Organization ID for the memory export.
>
> **run\_id** `string`
>
> Filter to export memories for a specific Run ID. At least one of user\_id, agent\_id, app\_id, or run\_id must be provided.
>
> **schema** `object`
>
> Schema definition for the export structure. Defaults to \{"type": "object", "properties": \{"memory": \{"type": "string"}}} if not provided.
>
> **filters** `object`
>
> Internal field used to structure filters for the API. Automatically populated from user\_id, agent\_id, app\_id, and run\_id fields.
>
> **user\_id** `string`
>
> Filter to export memories for a specific User ID. At least one of user\_id, agent\_id, app\_id, or run\_id must be provided.
>
> **agent\_id** `string`
>
> Filter to export memories for a specific Agent ID. At least one of user\_id, agent\_id, app\_id, or run\_id must be provided.
>
> **project\_id** `string` *required*
>
> Project ID for the memory export.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List organizations
>
> **Slug:** `MEM0_FETCH_DETAILED_LIST_OF_ORGANIZATIONS`
>
> Retrieves a list of organizations with their details, including IDs, names, ownership, members and plan information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch details of a specific organization
>
> **Slug:** `MEM0_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.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> Unique identifier of the organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get list of entity filters
>
> **Slug:** `MEM0_FETCH_LIST_OF_ENTITY_FILTERS`
>
> Retrieves entity filters from the entity filters endpoint, with a response modeled as a list of entities.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get entity by id
>
> **Slug:** `MEM0_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.
>
> #### Input Parameters
>
> **entity\_id** `integer` *required*
>
> The unique integer identifier (ID) of the entity to retrieve. Must be a positive integer.
>
> **entity\_type** `string` *required*
>
> The type of the entity (user, agent, app, or run).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get event status by event ID
>
> **Slug:** `MEM0_GET_EVENT_STATUS_BY_EVENT_ID`
>
> Retrieves a single async event by ID to check its current status and results. Use this after operations that return event IDs (e.g., add\_new\_memory\_records) to poll for completion before proceeding with dependent operations.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> Unique identifier of the event to retrieve (UUID format).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get memories by entity
>
> **Slug:** `MEM0_GET_MEMORIES_BY_ENTITY`
>
> Retrieves memories associated with a specified user, agent, app, or run by entity type and ID, with optional pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (1-indexed). Default: 1.
>
> **entity\_id** `string` *required*
>
> The unique identifier of the entity whose memories to retrieve.
>
> **page\_size** `integer`
>
> Number of memories to return per page. Default: 100.
>
> **entity\_type** `string ("user" | "agent" | "app" | "run")` *required*
>
> Type of the entity. Must be one of: 'user', 'agent', 'app', 'run'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get memory export
>
> **Slug:** `MEM0_GET_MEMORY_EXPORT`
>
> Retrieves the status and results of a memory export job by its ID. Use this after creating an export job to fetch the processed memory data. The response structure matches the schema defined during export creation.
>
> #### Input Parameters
>
> **org\_id** `string`
>
> Organization ID filter. Can be an empty string if not filtering by organization.
>
> **project\_id** `string`
>
> Project ID filter. Can be an empty string if not filtering by project.
>
> **memory\_export\_id** `string` *required*
>
> The unique identifier (UUID format) of the memory export job to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get organization members
>
> **Slug:** `MEM0_GET_ORGANIZATION_MEMBERS`
>
> Fetches a list of members for a specified, existing organization.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> The unique identifier of the organization for which members are to be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project details
>
> **Slug:** `MEM0_GET_PROJECT_DETAILS`
>
> Fetches comprehensive details for a specified project within an organization.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> The unique identifier for the organization to which the project belongs.
>
> **project\_id** `string` *required*
>
> The unique identifier for the project whose details are to be retrieved.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project members
>
> **Slug:** `MEM0_GET_PROJECT_MEMBERS`
>
> Retrieves all members for a specified project within an organization.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> Unique identifier of the organization.
>
> **project\_id** `string` *required*
>
> Unique identifier of the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get projects
>
> **Slug:** `MEM0_GET_PROJECTS`
>
> Retrieves all projects for a given organization `org_id` to which the caller has access.
>
> #### Input Parameters
>
> **org\_id** `string` *required*
>
> The unique identifier of the organization for which to retrieve projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project webhooks
>
> **Slug:** `MEM0_GET_PROJECT_WEBHOOKS`
>
> Retrieves all webhooks configured for a specific project. Use this to list webhook configurations including their event types, URLs, and active status.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> Unique identifier of the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user memory stats
>
> **Slug:** `MEM0_GET_USER_MEMORY_STATS`
>
> Retrieves a summary of the authenticated user's memory activity, including total memories created, search events, and add events. Note: This endpoint is undocumented in the official mem0 API specification but is functional.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List entities
>
> **Slug:** `MEM0_LIST_ENTITIES_WITH_OPTIONAL_ORG_AND_PROJECT_FILTERS`
>
> Retrieves entities with optional organization and project filters; results may be summaries and subject to limits. Organization and project IDs must be supplied together and are preferred over deprecated name filters.
>
> #### Input Parameters
>
> **org\_id** `string`
>
> Filter entities by the unique identifier of the organization. Must be provided together with project\_id (both or neither).
>
> **org\_name** `string`
>
> Filter entities by organization name; this field is deprecated, prefer using `org_id` for more stable filtering.
>
> **project\_id** `string`
>
> Filter entities by the unique identifier of the project. Must be provided together with org\_id (both or neither).
>
> **project\_name** `string`
>
> Filter entities by project name; this field is deprecated, prefer using `project_id` for more stable filtering.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Perform semantic search on memories
>
> **Slug:** `MEM0_PERFORM_SEMANTIC_SEARCH_ON_MEMORIES`
>
> Searches memories using a natural language query and optional filters, or requests metadata-only search. At least one user, agent, or run ID and a query string are required; the query may be blank for metadata-only search.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Natural language search query for semantic search. Must be a non-empty string. IMPORTANT: If you need to retrieve all memories for a user/agent without a specific search query, use the 'retrieve\_memory\_list' action (GET /v1/memories/) instead, which supports filtering by user\_id, agent\_id, metadata, and other parameters without requiring a semantic search query.
>
> **top\_k** `integer`
>
> Maximum number of relevant memory results to return.
>
> **app\_id** `string`
>
> Filter by application ID. Optional additional filter.
>
> **fields** `array`
>
> Specific field names for inclusion in response for each memory; if empty/unprovided, all fields are returned.
>
> **org\_id** `string`
>
> Filter memories by organization ID.
>
> **rerank** `boolean`
>
> If true, applies an additional reranking step to search results for potentially improved relevance.
>
> **run\_id** `string`
>
> Filter by run ID. REQUIRED: At least one of 'user\_id', 'agent\_id', or 'run\_id' must be provided.
>
> **user\_id** `string`
>
> Filter by user ID. REQUIRED: At least one of 'user\_id', 'agent\_id', or 'run\_id' must be provided. This is the most commonly used filter.
>
> **agent\_id** `string`
>
> Filter by agent ID. REQUIRED: At least one of 'user\_id', 'agent\_id', or 'run\_id' must be provided.
>
> **metadata** `object`
>
> A dictionary of key-value pairs to filter memories. Only memories matching all key-value pairs in the provided metadata will be returned.
>
> **org\_name** `string`
>
> Filter memories by organization name (deprecated; use `org_id` instead).
>
> **categories** `array`
>
> Filter memories by a list of categories; returns memories matching at least one category.
>
> **project\_id** `string`
>
> Filter memories by project ID.
>
> **project\_name** `string`
>
> Filter memories by project name (deprecated; use `project_id` instead).
>
> **output\_format** `string`
>
> Specifies the output format for results. 'v1.0' is used if not provided. Supported: 'v1.0', 'v1.1'.
>
> **filter\_memories** `boolean`
>
> If true, strictly applies all provided metadata filters (e.g., `user_id`, `agent_id`, `categories`).
>
> **only\_metadata\_based\_search** `boolean`
>
> If true, search uses only the 'metadata' parameter for filtering (query is ignored for semantic matching). When true, the 'metadata' parameter must be provided. NOTE: This parameter may not be supported in all API versions. For simple retrieval of all memories without semantic search, use the 'retrieve\_memory\_list' action instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove a member from the organization
>
> **Slug:** `MEM0_REMOVE_A_MEMBER_FROM_THE_ORGANIZATION`
>
> Removes a member from an organization using the organization ID and member's email address.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address of the member to be removed from the organization.
>
> **org\_id** `string` *required*
>
> Unique identifier of the organization from which the member will be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve all events for the currently logged in user
>
> **Slug:** `MEM0_RETRIEVE_ALL_EVENTS_FOR_THE_CURRENTLY_LOGGED_IN_USER`
>
> Retrieves a paginated list of events for the authenticated user in a read-only operation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve list of memory events
>
> **Slug:** `MEM0_RETRIEVE_LIST_OF_MEMORY_EVENTS`
>
> Retrieves memory events from the Mem0 platform, providing interaction history and context for AI assistants. The response can include pagination information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve memory by id
>
> **Slug:** `MEM0_RETRIEVE_MEMORY_BY_UNIQUE_IDENTIFIER`
>
> Retrieves a complete memory entry by its unique identifier; `memory_id` must be valid and for an existing memory.
>
> #### Input Parameters
>
> **memory\_id** `string` *required*
>
> Unique identifier of the memory to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve memory history by id
>
> **Slug:** `MEM0_RETRIEVE_MEMORY_HISTORY_BY_ID`
>
> Retrieves the version history of a Mem0 memory by its ID, allowing you to inspect its evolution and audit changes.
>
> #### Input Parameters
>
> **memory\_id** `string` *required*
>
> Unique identifier of the memory for which history is to be retrieved.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve memory list
>
> **Slug:** `MEM0_RETRIEVE_MEMORY_LIST`
>
> Retrieves a paginated list of memories filtered by IDs, metadata, keywords, dates, and other criteria. At least one of agent\_id, user\_id, app\_id, or run\_id is required; org\_id and project\_id must be supplied together or both omitted.
>
> #### Input Parameters
>
> **page** `integer`
>
> The page number for pagination, starting from 1. Default: 1.
>
> **app\_id** `string`
>
> The unique identifier of the application associated with the memories. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **fields** `array`
>
> A list of specific field names to consider during filtering. This might involve checking for the existence of these fields or scoping other filters (e.g., keywords) to them.
>
> **org\_id** `string`
>
> The unique identifier of the organization to filter memories by. Must be provided together with project\_id, or both must be omitted.
>
> **run\_id** `string`
>
> The unique identifier of a specific run or session to filter memories by. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **user\_id** `string`
>
> The unique identifier of the user whose memories are to be retrieved. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **agent\_id** `string`
>
> The unique identifier of the agent associated with the memories to be retrieved. At least one of user\_id, agent\_id, app\_id, or run\_id is required.
>
> **end\_date** `string`
>
> The end date (inclusive) for filtering memories, typically in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ' or 'YYYY-MM-DD').
>
> **keywords** `string`
>
> Keywords to search for within the memories. The search might be across all text fields or restricted by the `fields` parameter if specified.
>
> **metadata** `object`
>
> A dictionary of key-value pairs to filter memories. Only memories matching all key-value pairs in the provided metadata will be returned.
>
> **org\_name** `string`
>
> The name of the organization to filter memories by. This field is deprecated and will be removed in a future version; please use `org_id` instead.
>
> **page\_size** `integer`
>
> The number of memories to return per page. Default: 100.
>
> **categories** `array`
>
> A list of categories to filter memories by. Memories matching any of the specified categories will be returned.
>
> **project\_id** `string`
>
> The unique identifier of the project to filter memories by. Must be provided together with org\_id, or both must be omitted.
>
> **start\_date** `string`
>
> The start date (inclusive) for filtering memories, typically in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ' or 'YYYY-MM-DD').
>
> **project\_name** `string`
>
> The name of the project to filter memories by. This field is deprecated and will be removed in a future version; please use `project_id` instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search memories with filters
>
> **Slug:** `MEM0_SEARCH_MEMORIES_WITH_QUERY_FILTERS`
>
> Searches memories using a required nonempty set of structured filters and an optional natural language query, which defaults to '\*'. Supports reranking, field selection, similarity thresholds, and keyword search.
>
> #### Input Parameters
>
> **query** `string`
>
> Natural language query for searching memories. The API requires this field to be non-blank, so it defaults to '*' for filter-only searches. Omit or use '*' to retrieve memories matching only the filters without semantic search constraints.
>
> **top\_k** `integer`
>
> Maximum number of most relevant search results to return.
>
> **fields** `array`
>
> Specific field names to include in returned memory objects (e.g., 'text', 'source', 'metadata.custom\_field'). If omitted, all fields are returned.
>
> **org\_id** `string`
>
> UUID of the organization to scope the memory search; preferred over `org_name`.
>
> **rerank** `boolean`
>
> If true, applies a secondary reranking model to initial search results for improved relevance.
>
> **filters** `object` *required*
>
> REQUIRED and cannot be empty - must contain at least one filter condition. Available filter fields: user\_id, agent\_id, app\_id, run\_id, created\_at, updated\_at, categories, keywords. Filters can be provided in two formats: (1) Simple key-value pairs: `{"user_id": "alice"}` for equality matching or `{"created_at": {"gte": "2023-01-01T00:00:00Z"}}` with comparison operators. (2) Wrapped in logical operators: `{"AND": [{"user_id": "alice"}]}` for combining multiple conditions. Comparison operators (lowercase): `in` (matches any value in list), `gte` (>=), `lte` (\<=), `gt` (>), `lt` (\<), `ne` (not equal), `contains`, `icontains` (case-insensitive). Logical operators (`AND`, `OR`, `NOT`) must be UPPERCASE and take a list of conditions. Use `*` as wildcard to match any value for a field (e.g., `{"user_id": "*"}` to match all users).
>
> **org\_name** `string`
>
> Deprecated: Name of the organization to scope the memory search. Use `org_id` instead for improved accuracy and stability.
>
> **threshold** `number`
>
> Minimum similarity threshold for search results (0.0 to 1.0). Higher values return more relevant but fewer results.
>
> **project\_id** `string`
>
> UUID of the project to scope the memory search; preferred over `project_name`.
>
> **project\_name** `string`
>
> Deprecated: Name of the project to scope the memory search. Use `project_id` instead for improved accuracy and stability.
>
> **keyword\_search** `boolean`
>
> Whether to search for memories based on keywords instead of semantic similarity.
>
> **filter\_memories** `boolean`
>
> Whether to strictly apply all provided metadata filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update memory batch with uuid
>
> **Slug:** `MEM0_UPDATE_MEMORY_BATCH_WITH_UUID`
>
> Updates text for up to 1000 memories in a single batch, using their UUIDs.
>
> #### Input Parameters
>
> **org\_id** `string`
>
> The organization ID for the batch update operation. If not provided, defaults to the user's default organization.
>
> **memories** `array` *required*
>
> List of memory update operations, each specifying a memory ID and its new text.
>
> **project\_id** `string`
>
> The project ID for the batch update operation. If not provided, defaults to the user's default project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update memory text content
>
> **Slug:** `MEM0_UPDATE_MEMORY_DETAILS_BY_ID`
>
> Updates the text and/or metadata of an existing memory identified by its memory ID.
>
> #### Input Parameters
>
> **text** `string`
>
> New text content to replace the memory's existing text. At least one of 'text' or 'metadata' should be provided.
>
> **metadata** `object`
>
> Supplementary metadata to update for the memory. Can be used to add or modify key-value pairs associated with the memory.
>
> **memory\_id** `string` *required*
>
> The unique identifier of the memory whose text content is to be updated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update organization member role
>
> **Slug:** `MEM0_UPDATE_ORGANIZATION_MEMBER_ROLE`
>
> Updates the role of an existing member to a new valid role within an existing organization.
>
> #### Input Parameters
>
> **role** `string` *required*
>
> New role to assign to the member. Valid values are 'OWNER' and 'READER' (must be uppercase).
>
> **email** `string` *required*
>
> Email address of the existing member or invitee whose role will be updated.
>
> **org\_id** `string` *required*
>
> Identifier of the existing organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project
>
> **Slug:** `MEM0_UPDATE_PROJECT`
>
> Updates a project within an organization using the provided name, description, custom instructions, or custom categories. Category objects are submitted without their input fields; an empty category list can be sent to clear them.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the project.
>
> **org\_id** `string` *required*
>
> Organization's unique identifier.
>
> **project\_id** `string` *required*
>
> Project's unique identifier to be updated.
>
> **description** `string`
>
> New description for the project.
>
> **custom\_categories** `array`
>
> New list of custom category objects. Fully replaces existing categories; an empty list (`[]`) clears them.
>
> **custom\_instructions** `string`
>
> Custom instructions to guide memory processing as a single string. Pass an empty string ('') to clear existing instructions. If you have multiple instructions, combine them into one string separated by periods or newlines.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update project member role
>
> **Slug:** `MEM0_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.
>
> #### Input Parameters
>
> **role** `string` *required*
>
> The new role to assign to the member within the project. Must be either 'OWNER' or 'READER'.
>
> **email** `string` *required*
>
> The email address of the member whose role is to be updated within the specified project.
>
> **org\_id** `string` *required*
>
> Unique identifier of the organization where the project resides.
>
> **project\_id** `string` *required*
>
> Unique identifier of the project where the member's role will be updated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
