Skip to main content
Mem0 logo
  • Category: artificial intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 47
  • Triggers: 0
  • Slug: MEM0
  • Version: 20261101_00

Tools

Slug: MEM0_ADD_MEMBER_TO_PROJECTAdds an existing user to a project (identified by project_id within organization org_id), assigning a valid system role.

Input Parameters

string
required
Role defining the new member’s project permissions. Must be either ‘OWNER’ or ‘READER’.
string
required
Email address of the user to add to the project.
string
required
Identifier of the organization owning the project.
string
required
Identifier of the project to add the member to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_ADD_NEW_MEMORY_RECORDSAdds 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

boolean
If true, infers structured memories from messages; otherwise, stores messages directly.
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.
string
Optional unique identifier for the organization associated with this memory.
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.
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.
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.
string
Comma-separated keywords to exclude specific topics, aiding in filtering out irrelevant information.
string
Comma-separated keywords to include specific topics, aiding filtering and prioritization.
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.
string
The name of the organization for this memory. Deprecated: use org_id instead.
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.
string
Optional unique identifier for the project associated with this memory.
string
The name of the project for this memory. Deprecated: use project_id instead.
string
Specifies the response output format. ‘v1.1’ offers enhanced detail; ‘v1.0’ (default) will be deprecated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_ADD_ORGANIZATION_MEMBERAdds a new member, who must be a registered user, to an organization, assigning them a specific role.

Input Parameters

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.
string
required
The email of the user to be added to the organization.
string
required
Unique identifier of the organization to which the member will be added.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_A_NEW_AGENTCreates a new agent with a unique agent ID and a required name; additional metadata may be assigned by the system.

Input Parameters

string
required
Human-readable name for the agent, used for display or easier identification. This field is required by the API.
string
required
Unique identifier for the agent, used for referencing in subsequent API calls.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_A_NEW_AGENT_RUNCreates a new agent run in the mem0.ai system.

Input Parameters

string
required
Human-readable name for the agent run. Required by the API.
string
required
Client-defined identifier for the agent run. Should be unique for distinct identification.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_A_NEW_APPLICATIONCreates a new application with an application ID and name; ensure the app ID is unique to avoid potential errors or unintended updates.

Input Parameters

string
required
A required, human-readable name for the application. The API requires this field to be provided.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_A_NEW_ORGANIZATION_ENTRYCreates a new organization entry using the provided name and returns its details.

Input Parameters

string
required
The name for the new organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_A_NEW_USERCreates a new user with the specified unique user ID and optional metadata.

Input Parameters

string
required
The unique identifier for the new user. This ID will be used for future references to this user.
object
Additional metadata to associate with the user

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_MEMORY_ENTRYLists 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

integer
Page number for paginated results (1-indexed).
string
Unique organization ID to filter memories. Preferred over the deprecated org_name.
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.
string
DEPRECATED: Organization name to filter memories. Use org_id instead for improved stability and future compatibility.
integer
Number of memory entries per page.
string
Unique project ID to filter memories. Preferred over the deprecated project_name.
string
DEPRECATED: Project name to filter memories. Use project_id instead for improved stability and future compatibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_PROJECTCreates a new project with a given name within an organization that must already exist.

Input Parameters

string
required
The name to be assigned to the new project.
string
required
The unique identifier of the organization under which the new project will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_CREATE_WEBHOOKCreates 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

string
required
URL endpoint where webhook events will be sent. Must be a valid HTTPS URL.
string
Human-readable name for the webhook to help identify its purpose.
boolean
Whether the webhook should be active immediately after creation. Defaults to true if not specified.
string
required
Unique identifier of the project to create the webhook for.
array
List of event types to subscribe to. If not specified, webhook will receive all event types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_AN_ORGANIZATIONPermanently deletes an existing organization identified by its unique ID.

Input Parameters

string
required
The unique identifier of the organization that is to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_A_SPECIFIC_MEMORY_BY_IDPermanently deletes a specific memory by its unique ID; ensure the memory_id exists as this operation is irreversible.

Input Parameters

string
required
The unique identifier of the memory to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_ENTITY_BY_TYPE_AND_IDCall 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

string
required
Unique identifier (ID) of the entity for deletion. Can be an integer ID or a string identifier.
string ("user" | "agent" | "app" | "run")
required
Type of the entity to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_MEMORIES_ENDPOINTDeletes 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

string
Deletes all memories associated with this app ID. At least one of user_id, agent_id, app_id, or run_id is required.
string
Organization ID to scope the deletion. Preferred over org_name.
string
Deletes all memories associated with this run ID. At least one of user_id, agent_id, app_id, or run_id is required.
string
Deletes all memories associated with this user ID. At least one of user_id, agent_id, app_id, or run_id is required.
string
Deletes all memories associated with this agent ID. At least one of user_id, agent_id, app_id, or run_id is required.
object
Optional additional filter: deletes memories matching this metadata criteria.
string
Organization name to scope the deletion. Deprecated: use org_id instead.
string
Project ID to scope the deletion. Preferred over project_name.
string
Project name to scope the deletion. Deprecated: use project_id instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_MEMORY_BATCH_WITH_UUIDSDeletes a batch of up to 1000 existing memories, identified by their UUIDs, in a single API call.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_PROJECTPermanently 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

string
required
The unique identifier of the organization to which the project belongs.
string
required
The unique identifier of the project to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_PROJECT_MEMBERRemoves 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

string
required
Email address of the member to be removed from the project.
string
required
Unique identifier of the organization containing the project.
string
required
Unique identifier of the project from which the member will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_DELETE_WEBHOOKDeletes 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

string
required
Unique identifier of the webhook to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_EXPORT_DATA_BASED_ON_FILTERSCreates 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

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.
string
required
Organization ID for the memory export.
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.
object
Schema definition for the export structure. Defaults to {“type”: “object”, “properties”: {“memory”: {“type”: “string”}}} if not provided.
object
Internal field used to structure filters for the API. Automatically populated from user_id, agent_id, app_id, and run_id fields.
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.
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.
string
required
Project ID for the memory export.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_FETCH_DETAILED_LIST_OF_ORGANIZATIONSRetrieves a list of organizations with their details, including IDs, names, ownership, members and plan information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_FETCH_DETAILS_OF_A_SPECIFIC_ORGANIZATIONFetches comprehensive details for an organization using its org_id; the org_id must be valid and for an existing organization.

Input Parameters

string
required
Unique identifier of the organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_FETCH_LIST_OF_ENTITY_FILTERSRetrieves entity filters from the entity filters endpoint, with a response modeled as a list of entities.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_FETCH_SPECIFIC_ENTITY_DETAILS_WITH_OPTIONAL_FILTERSFetches detailed information for an existing entity (user, agent, app, or run) identified by its type and unique ID.

Input Parameters

integer
required
The unique integer identifier (ID) of the entity to retrieve. Must be a positive integer.
string
required
The type of the entity (user, agent, app, or run).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_EVENT_STATUS_BY_EVENT_IDRetrieves 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

string
required
Unique identifier of the event to retrieve (UUID format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_MEMORIES_BY_ENTITYRetrieves memories associated with a specified user, agent, app, or run by entity type and ID, with optional pagination.

Input Parameters

integer
Page number for paginated results (1-indexed). Default: 1.
string
required
The unique identifier of the entity whose memories to retrieve.
integer
Number of memories to return per page. Default: 100.
string ("user" | "agent" | "app" | "run")
required
Type of the entity. Must be one of: ‘user’, ‘agent’, ‘app’, ‘run’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_MEMORY_EXPORTRetrieves 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

string
Organization ID filter. Can be an empty string if not filtering by organization.
string
Project ID filter. Can be an empty string if not filtering by project.
string
required
The unique identifier (UUID format) of the memory export job to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_ORGANIZATION_MEMBERSFetches a list of members for a specified, existing organization.

Input Parameters

string
required
The unique identifier of the organization for which members are to be listed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_PROJECT_DETAILSFetches comprehensive details for a specified project within an organization.

Input Parameters

string
required
The unique identifier for the organization to which the project belongs.
string
required
The unique identifier for the project whose details are to be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_PROJECT_MEMBERSRetrieves all members for a specified project within an organization.

Input Parameters

string
required
Unique identifier of the organization.
string
required
Unique identifier of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_PROJECTSRetrieves all projects for a given organization org_id to which the caller has access.

Input Parameters

string
required
The unique identifier of the organization for which to retrieve projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_PROJECT_WEBHOOKSRetrieves all webhooks configured for a specific project. Use this to list webhook configurations including their event types, URLs, and active status.

Input Parameters

string
required
Unique identifier of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_GET_USER_MEMORY_STATSRetrieves 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_LIST_ENTITIES_WITH_OPTIONAL_ORG_AND_PROJECT_FILTERSRetrieves 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

string
Filter entities by the unique identifier of the organization. Must be provided together with project_id (both or neither).
string
Filter entities by organization name; this field is deprecated, prefer using org_id for more stable filtering.
string
Filter entities by the unique identifier of the project. Must be provided together with org_id (both or neither).
string
Filter entities by project name; this field is deprecated, prefer using project_id for more stable filtering.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_PERFORM_SEMANTIC_SEARCH_ON_MEMORIESSearches 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

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.
integer
Maximum number of relevant memory results to return.
string
Filter by application ID. Optional additional filter.
array
Specific field names for inclusion in response for each memory; if empty/unprovided, all fields are returned.
string
Filter memories by organization ID.
boolean
If true, applies an additional reranking step to search results for potentially improved relevance.
string
Filter by run ID. REQUIRED: At least one of ‘user_id’, ‘agent_id’, or ‘run_id’ must be provided.
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.
string
Filter by agent ID. REQUIRED: At least one of ‘user_id’, ‘agent_id’, or ‘run_id’ must be provided.
object
A dictionary of key-value pairs to filter memories. Only memories matching all key-value pairs in the provided metadata will be returned.
string
Filter memories by organization name (deprecated; use org_id instead).
array
Filter memories by a list of categories; returns memories matching at least one category.
string
Filter memories by project ID.
string
Filter memories by project name (deprecated; use project_id instead).
string
Specifies the output format for results. ‘v1.0’ is used if not provided. Supported: ‘v1.0’, ‘v1.1’.
boolean
If true, strictly applies all provided metadata filters (e.g., user_id, agent_id, categories).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_REMOVE_A_MEMBER_FROM_THE_ORGANIZATIONRemoves a member from an organization using the organization ID and member’s email address.

Input Parameters

string
required
The email address of the member to be removed from the organization.
string
required
Unique identifier of the organization from which the member will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_RETRIEVE_ALL_EVENTS_FOR_THE_CURRENTLY_LOGGED_IN_USERRetrieves a paginated list of events for the authenticated user in a read-only operation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_RETRIEVE_LIST_OF_MEMORY_EVENTSRetrieves memory events from the Mem0 platform, providing interaction history and context for AI assistants. The response can include pagination information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_RETRIEVE_MEMORY_BY_UNIQUE_IDENTIFIERRetrieves a complete memory entry by its unique identifier; memory_id must be valid and for an existing memory.

Input Parameters

string
required
Unique identifier of the memory to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_RETRIEVE_MEMORY_HISTORY_BY_IDRetrieves the version history of a Mem0 memory by its ID, allowing you to inspect its evolution and audit changes.

Input Parameters

string
required
Unique identifier of the memory for which history is to be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_RETRIEVE_MEMORY_LISTRetrieves 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

integer
The page number for pagination, starting from 1. Default: 1.
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.
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.
string
The unique identifier of the organization to filter memories by. Must be provided together with project_id, or both must be omitted.
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.
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.
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.
string
The end date (inclusive) for filtering memories, typically in ISO 8601 format (e.g., ‘YYYY-MM-DDTHH:MM:SSZ’ or ‘YYYY-MM-DD’).
string
Keywords to search for within the memories. The search might be across all text fields or restricted by the fields parameter if specified.
object
A dictionary of key-value pairs to filter memories. Only memories matching all key-value pairs in the provided metadata will be returned.
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.
integer
The number of memories to return per page. Default: 100.
array
A list of categories to filter memories by. Memories matching any of the specified categories will be returned.
string
The unique identifier of the project to filter memories by. Must be provided together with org_id, or both must be omitted.
string
The start date (inclusive) for filtering memories, typically in ISO 8601 format (e.g., ‘YYYY-MM-DDTHH:MM:SSZ’ or ‘YYYY-MM-DD’).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_SEARCH_MEMORIES_WITH_QUERY_FILTERSSearches 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

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.
integer
Maximum number of most relevant search results to return.
array
Specific field names to include in returned memory objects (e.g., ‘text’, ‘source’, ‘metadata.custom_field’). If omitted, all fields are returned.
string
UUID of the organization to scope the memory search; preferred over org_name.
boolean
If true, applies a secondary reranking model to initial search results for improved relevance.
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).
string
Deprecated: Name of the organization to scope the memory search. Use org_id instead for improved accuracy and stability.
number
Minimum similarity threshold for search results (0.0 to 1.0). Higher values return more relevant but fewer results.
string
UUID of the project to scope the memory search; preferred over project_name.
string
Deprecated: Name of the project to scope the memory search. Use project_id instead for improved accuracy and stability.
Whether to search for memories based on keywords instead of semantic similarity.
boolean
Whether to strictly apply all provided metadata filters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_UPDATE_MEMORY_BATCH_WITH_UUIDUpdates text for up to 1000 memories in a single batch, using their UUIDs.

Input Parameters

string
The organization ID for the batch update operation. If not provided, defaults to the user’s default organization.
array
required
List of memory update operations, each specifying a memory ID and its new text.
string
The project ID for the batch update operation. If not provided, defaults to the user’s default project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_UPDATE_MEMORY_DETAILS_BY_IDUpdates the text and/or metadata of an existing memory identified by its memory ID.

Input Parameters

string
New text content to replace the memory’s existing text. At least one of ‘text’ or ‘metadata’ should be provided.
object
Supplementary metadata to update for the memory. Can be used to add or modify key-value pairs associated with the memory.
string
required
The unique identifier of the memory whose text content is to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_UPDATE_ORGANIZATION_MEMBER_ROLEUpdates the role of an existing member to a new valid role within an existing organization.

Input Parameters

string
required
New role to assign to the member. Valid values are ‘OWNER’ and ‘READER’ (must be uppercase).
string
required
Email address of the existing member or invitee whose role will be updated.
string
required
Identifier of the existing organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_UPDATE_PROJECTUpdates 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

string
New name for the project.
string
required
Organization’s unique identifier.
string
required
Project’s unique identifier to be updated.
string
New description for the project.
array
New list of custom category objects. Fully replaces existing categories; an empty list ([]) clears them.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MEM0_UPDATE_PROJECT_MEMBER_ROLEUpdates the role of a specific member within a designated project, ensuring the new role is valid and recognized by the system.

Input Parameters

string
required
The new role to assign to the member within the project. Must be either ‘OWNER’ or ‘READER’.
string
required
The email address of the member whose role is to be updated within the specified project.
string
required
Unique identifier of the organization where the project resides.
string
required
Unique identifier of the project where the member’s role will be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not