Mem0

Mem0 API

mem0.ai API Docs

AI & machine learning#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

mem0.ai API Docs

Endpoints 68

agents

  • POSTagents_create/v1/agents/Create a new Agent.

apps

  • POSTapps_create/v1/apps/Create a new App.

entities

  • GETentities_list/v1/entities/
  • GETentities_filters_list/v1/entities/filters/
  • DELETEentities_delete_v1/v1/entities/:entity_type/:entity_id/Deprecated. Delete an entity by its numeric ID. Deprecated in favor of DELETE /v2/entities/{entity_type}/{entity_id}/, which takes the entity's string name…
  • GETentities_read/v2/entities/:entity_type/:entity_id/
  • DELETEentities_delete/v2/entities/:entity_type/:entity_id/

events

  • GETRetrieve all events for current organization and project./v1/events/
  • GETRetrieve details of a specific event by its ID./v1/event/:event_id/

exports

  • POSTCreate an export job with schema/v1/exports/Create a structured export of memories based on a provided schema.
  • POSTExport data based on filters/v1/exports/get/Get the latest memory export.

memories

  • GETmemories_list/v1/memories/Deprecated. Get all memories.
  • POSTmemories_create/v1/memories/Deprecated. Add memories.
  • DELETEmemories_delete_all/v1/memories/Delete memories by filter. At least one filter is required. Previously, omitting all filters silently deleted everything; now it returns a validation error.
  • POSTmemories_list_v2/v2/memories/Deprecated. Get all memories.
  • GETmemories_events_list/v1/memories/events/Despite the endpoint name, this returns memory history entries (the same shape as GET /v1/memories/{memory_id}/history/), not event/ingestion-job records. For…
  • POSTmemories_search_create/v1/memories/search/Deprecated. Perform a semantic search on memories.
  • POSTmemories_search_v2/v2/memories/search/Deprecated. Search memories based on a query and filters.
  • POSTGet all memories (V3, paginated)/v3/memories/List memories scoped by filters, paginated. Entity IDs must be passed inside the filters object. Top-level user_id / agent_id / run_id are rejected with 400.…
  • POSTAdd memories (V3)/v3/memories/add/Extract and store memories from a conversation using the V3 additive pipeline. Entity IDs (user_id / agent_id / run_id) are accepted at the top level. At…
  • POSTSearch memories (V3)/v3/memories/search/Relevance-ranked search across stored memories. V3 uses hybrid retrieval and can also apply temporal reasoning for time-aware queries. Entity IDs must be…
  • GETmemories_entity_read/v1/memories/:entity_type/:entity_id/Returns a paginated list of memories belonging to the given entity.
  • GETmemories_read/v1/memories/:memory_id/Get a memory.
  • PUTmemories_update/v1/memories/:memory_id/Update a memory's text, metadata, or expiration date.
  • DELETEmemories_delete/v1/memories/:memory_id/Delete a memory.
  • GETmemories_history_list/v1/memories/:memory_id/history/Retrieve the history of a memory.
  • POSTGet a summary of memories matching the given filters./v1/summary/Backs the Python SDK's client.get_summary(). Not currently exposed by the TypeScript SDK.
  • PUTmemories_batch_update/v1/batch/Batch update multiple memories (up to 1000) in a single API call.
  • DELETEmemories_batch_delete/v1/batch/Batch delete multiple memories (up to 1000) in a single API call.

runs

  • POSTruns_create/v1/runs/Create a new Agent Run.

stats

  • GETRetrieve memory-related statistics for the authenticated user./v1/stats/This endpoint returns the following statistics: Total number of memories created Total number of search events Total number of add events
  • GETCheck API key validity and resolve organization/project context./v1/ping/Both the Python and TypeScript SDKs call this endpoint on client construction to validate the API key and resolve the default org_id and project_id.

users

  • POSTusers_create/v1/users/Create a new User.

feedback

  • POSTsubmit_feedback/v1/feedback/Submit feedback for a memory.

organizations

  • GETorganizations_read/api/v1/orgs/organizations/
  • POSTcreate_organization/api/v1/orgs/organizations/Create a new organization.
  • GETget_organization/api/v1/orgs/organizations/:org_id/Get a organization.
  • DELETEDelete an organization/api/v1/orgs/organizations/:org_id/Delete an organization by its ID.
  • GETGet organization members/api/v1/orgs/organizations/:org_id/members/Retrieve a list of members for a specific organization.
  • PUTUpdate organization member role/api/v1/orgs/organizations/:org_id/members/Update the role of an existing member in a specific organization.
  • POSTAdd organization member/api/v1/orgs/organizations/:org_id/members/Add a new member to a specific organization.
  • DELETERemove a member from the organization/api/v1/orgs/organizations/:org_id/members/

projects

  • GETGet projects/api/v1/orgs/organizations/:org_id/projects/Retrieve a list of projects for a specific organization.
  • POSTCreate project/api/v1/orgs/organizations/:org_id/projects/Create a new project within an organization.
  • GETGet project details/api/v1/orgs/organizations/:org_id/projects/:project_id/Retrieve details of a specific project within an organization.
  • DELETEDelete Project/api/v1/orgs/organizations/:org_id/projects/:project_id/Delete a specific project and its related data.
  • PATCHUpdate Project/api/v1/orgs/organizations/:org_id/projects/:project_id/Update a specific project's settings.
  • GETGet Project Members/api/v1/orgs/organizations/:org_id/projects/:project_id/members/Retrieve a list of members for a specific project.
  • PUTUpdate project member role/api/v1/orgs/organizations/:org_id/projects/:project_id/members/Update the role of a member in a specific project within an organization.
  • POSTAdd member to project/api/v1/orgs/organizations/:org_id/projects/:project_id/members/Add a new member to a specific project within an organization.

Project

  • DELETEDelete Project Member/api/v1/orgs/organizations/:org_id/projects/:project_id/members/?email=string

webhooks

  • GETGet Project Webhooks/api/v1/webhooks/projects/:project_id/Retrieve all webhooks for a specific project
  • POSTCreate Webhook/api/v1/webhooks/projects/:project_id/Create a new webhook for a specific project
  • PUTUpdate Webhook/api/v1/webhooks/:webhook_id/Update an existing webhook
  • DELETEDelete Webhook/api/v1/webhooks/:webhook_id/Delete an existing webhook

dream

  • GETGet Dream configuration/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/config/Retrieve the project's Dream (memory synthesis) configuration together with the plan entitlement snapshot. Dream automatically supersedes/merges memories on…
  • PATCHUpdate Dream configuration/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/config/Enable or disable Synthesis (reflection) for the project, or change the reflection mode. Requires a Pro or Enterprise (CUSTOM) plan and organization-owner…
  • GETGet Dream stats/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/stats/Lifecycle + synthesis counts for the project's Dream dashboard, plus reflection freshness. Requires a Pro or Enterprise (CUSTOM) plan.
  • GETGet Dream activity/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/activity/Supersede/merge activity feed (newest first), keyset-paginated. Synthesis output is not included here — see the runs endpoint.
  • GETGet Dream synthesis runs/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/runs/Synthesis activity grouped per run (newest first), keyset-paginated. Each run inlines its first page of synthesized memories with their sources; larger runs…
  • GETGet memories in a Dream run/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/runs/:run_id/memories/Keyset page of the synthesized memories within a single run (for runs whose has_more is true).
  • GETGet a synthesized memory's sources/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/memory/:memory_id/sources/The source memories a synthesized (pattern) memory was distilled from, for the memory drawer's provenance panel.
  • POSTPreview Dream scope/api/v1/orgs/organizations/:org_id/projects/:project_id/dream/preview/A no-write preview of the scope Dream synthesis would analyze for the project (a capped sample plus the count of users with enough memories to benefit). Never…

profiles

  • GETGet an entity's profile/v2/entities/:entity_type/:entity_id/profile/Return the memory profile for one user. Generation is asynchronous, so a known entity that has no profile yet is a normal 200 carrying a status. A 404 means…
  • GETGet profile settings/v2/profiles/settings/Return the profile settings for the project the API key is scoped to.
  • POSTUpdate profile settings/v2/profiles/settings/Update the project's profile settings. Only the fields present in the body are written, so one setting can change without re-sending the others.
  • POSTGenerate profiles/v2/profiles/jobs/Start one generation. operation says what to build: sample — up to 10 real entities, so a schema can be judged before it is used widely. These are real…
  • GETRead a generation job/v2/profiles/jobs/:job_id/The job nests under job. total is null until enumeration_complete, and completed is succeeded + failed + skipped.

API details

Base URL
https://api.mem0.ai
Authentication
An API key in the Authorization header
Operations
68 operations on 47 pathsGET 28POST 23DELETE 10PUT 5PATCH 2
6 marked deprecated
Main resources
memories 18dream 8organizations 8projects 8entities 5profiles 5webhooks 4events 2exports 2stats 2
Response formats
application/json
Description format
OpenAPI 3.0.1, API version v1

How to test the Mem0 API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Mem0 API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “agents_create” (POST /v1/agents/), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Mem0 API?

mem0.ai API Docs It is listed under AI & machine learning and has 68 endpoints.

Who publishes the Mem0 API?

It is listed from Mem0's public API description (an OpenAPI document), not published by Mem0 on Swastik Codes. Anyone who controls mem0.ai can claim the profile by adding a DNS TXT record.

What is the base URL of the Mem0 API?

Requests go to https://api.mem0.ai. Endpoint paths are added to this base URL.

How do I authenticate with the Mem0 API?

With an API key in the Authorization header.

How many endpoints does the Mem0 API have?

68 operations on 47 paths (28 GET, 23 POST, 10 DELETE, 5 PUT, 2 PATCH). The largest groups are memories, dream, organizations, projects.

Is forking the Mem0 API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.