{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"supermemory | Memory API for the AI era","description":"Frontier agent memory and context platform","colors":{"primary":"#091120","light":"#F5F5F5","dark":"#091120"},"logo":{"light":"https://mintcdn.com/supermemory/1szAHJ3-ym4bjQ4U/logo/light.svg?fit=max\u0026auto=format\u0026n=1szAHJ3-ym4bjQ4U\u0026q=85\u0026s=e4571d11b31900b962a200bf7206e7d9","dark":"https://mintcdn.com/supermemory/1szAHJ3-ym4bjQ4U/logo/dark.svg?fit=max\u0026auto=format\u0026n=1szAHJ3-ym4bjQ4U\u0026q=85\u0026s=23c339f1eafcd1c5ad241c14d94dad53"},"favicon":{"light":"https://mintcdn.com/supermemory/p0zPjih-OxhkPwgX/favicon-light-mode.png?fit=max\u0026auto=format\u0026n=p0zPjih-OxhkPwgX\u0026q=85\u0026s=2f4fb184e0e1a2b9a5e9fd27d3aca4b7","dark":"https://mintcdn.com/supermemory/p0zPjih-OxhkPwgX/favicon-dark-mode.png?fit=max\u0026auto=format\u0026n=p0zPjih-OxhkPwgX\u0026q=85\u0026s=839400ffc6b2249c0930e3d7376b4459"},"api":{"openapi":"https://api.supermemory.ai/v4/openapi","examples":{"defaults":"required","languages":["typescript","python","bash"],"prefill":true}},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"links":[{"href":"https://supermemory.ai/changelog","label":"Changelog"},{"href":"mailto:support@supermemory.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.supermemory.ai"}},"footer":{"socials":{"github":"https://github.com/supermemoryai","linkedin":"https://linkedin.com/company/supermemory","x":"https://x.com/supermemory"}},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"latex":false},"banner":{"content":"**v3 and v4 are deprecated and will be shut down on December 31, 2026.** Move to v5 before then. [Read the migration guide](/migration/api-v5).","dismissible":true},"contextual":{"options":["copy","view","assistant","chatgpt","claude","mcp","add-mcp","cursor","vscode","download-spec"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/supermemory/h0P1q8R9RVJPj3Y5/images/og-background.jpg?fit=max\u0026auto=format\u0026n=h0P1q8R9RVJPj3Y5\u0026q=85\u0026s=c415d91bd85a6db507dd36eb330edb9a","fonts":{"family":"Geist"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"supermemory","hasAudioNarration":false,"actualSubdomain":"supermemory","customDomains":["supermemory.ai","docs.supermemory.ai"],"gitSource":{"type":"github","owner":"supermemoryai","repo":"supermemory","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfafcdf6c8e67948a6ba8c","collectionId":"5540f7d0-e359-4796-8b96-34013bf27bad","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfafcdf6c8e67948a6ba8c"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adfafcdf6c8e67948a6ba8c","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Developer platform","count":187},{"language":"default","tag":"API reference","count":89},{"language":"default","tag":"Developer platform (API)","count":75},{"language":"default","tag":"Using supermemory","count":31},{"language":"default","tag":"Plugins and MCP","count":24},{"language":"default","tag":"API integrations","count":23},{"language":"default","tag":"Connectors","count":19},{"language":"default","tag":"Migration guides","count":15},{"language":"default","tag":"Ingest","count":13},{"language":"default","tag":"Connections","count":11}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@supermemory.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6902c52aad086969d32e674e","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"User profiles and tool use together for multimodal use cases","status":"active","generatedBy":"manual","createdAt":"2025-10-30T01:53:46.092Z","updatedAt":"2025-10-30T01:53:46.092Z","__v":0},{"_id":"6902c51ead086969d32e6474","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"I am building XYZ. how do I use user profiles with the python SDK?","status":"active","generatedBy":"manual","createdAt":"2025-10-30T01:53:34.162Z","updatedAt":"2025-10-30T01:53:34.162Z","__v":0}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/supermemory/58c42b69292eff61/style.css"}],"page":{"pagePath":"api-reference/profiles","slug":"/api-reference/profiles","pageMetadata":{"title":"Profiles","sidebarTitle":"Profiles overview","description":"Static and dynamic facts about an entity, scoped to a container.","icon":"/icons/hugeicons/id.svg","href":"/api-reference/profiles"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Static and dynamic facts about an entity, scoped to a container.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Table}=_components;if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Profiles summarize what Supermemory knows about a user or entity in a `,_jsx(_components.code,{children:`containerTag`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Use when`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v4/profile`})}),_jsx(_components.td,{children:`Fetch static + dynamic profile for a container`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v4/profile/buckets`})}),_jsx(_components.td,{children:`Profile organized by custom buckets`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Guides:`}),` `,_jsx(_components.a,{href:`/recall/user-profiles`,children:`User profiles API`}),` · `,_jsx(_components.a,{href:`/concepts/user-profiles`,children:`Concepts`}),` · `,_jsx(_components.a,{href:`/user-profiles/buckets`,children:`Buckets`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"config":{},"pageMetadata":{"title":"Profiles","sidebarTitle":"Profiles overview","description":"Static and dynamic facts about an entity, scoped to a container.","icon":"/icons/hugeicons/id.svg","href":"/api-reference/profiles"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/supermemory/71b914845a04a595/theme-switch.js"],"subdomain":"supermemory","siteName":"supermemory | Memory API for the AI era","title":"Profiles - supermemory | Memory API for the AI era","contextualStarterQuestions":[{"_id":"6abc578e463f3dac65bd6ce4","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"How do I fetch a user profile?","status":"active","generatedBy":"contextual","path":"api-reference/profiles","createdAt":"2026-09-30T00:27:58.532Z","updatedAt":"2026-09-30T00:27:58.532Z","__v":0},{"_id":"6abc578e463f3dac65bd6ce6","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"How do profiles work in containers?","status":"active","generatedBy":"contextual","path":"api-reference/profiles","createdAt":"2026-09-30T00:27:58.532Z","updatedAt":"2026-09-30T00:27:58.532Z","__v":0},{"_id":"6abc578e463f3dac65bd6ce5","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"What are profile buckets?","status":"active","generatedBy":"contextual","path":"api-reference/profiles","createdAt":"2026-09-30T00:27:58.532Z","updatedAt":"2026-09-30T00:27:58.532Z","__v":0}],"navMaps":{"firstHrefInVersion":{"Legacy (v3, v4)":{"href":"/api-reference/profiles","matchLevel":0},"Latest (v5)":{"href":"/v5/api-reference/profiles","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T00:27:35.707Z","originalFileLocation":"api-reference/profiles.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Static and dynamic facts about an entity, scoped to a container.\">\u003cmeta data-mint-head name=\"application-name\" content=\"supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Profiles - supermemory | Memory API for the AI era\">\u003cmeta data-mint-head property=\"og:description\" content=\"Static and dynamic facts about an entity, scoped to a container.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"supermemory | Memory API for the AI era\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://supermemory.ai/docs/api-reference/profiles\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://supermemory.mintlify.app/_mintlify/api/og/v2?division=Recall\u0026amp;title=Profiles\u0026amp;description=Static+and+dynamic+facts+about+an+entity%2C+scoped+to+a+container.\u0026amp;theme=56f8f47184c0da030f976e8e\u0026amp;signature=c22e8ce9d6b417262bc12c172988989b7da8bddd372444976a9408bbf224c82a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Profiles - supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Static and dynamic facts about an entity, scoped to a container.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supermemory.mintlify.app/_mintlify/api/og/v2?division=Recall\u0026amp;title=Profiles\u0026amp;description=Static+and+dynamic+facts+about+an+entity%2C+scoped+to+a+container.\u0026amp;theme=56f8f47184c0da030f976e8e\u0026amp;signature=c22e8ce9d6b417262bc12c172988989b7da8bddd372444976a9408bbf224c82a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#091120\">\u003clink data-mint-head rel=\"canonical\" href=\"https://supermemory.ai/docs/api-reference/profiles\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/profiles.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://supermemory.ai/#organization\",\"name\":\"supermemory | Memory API for the AI era\",\"url\":\"https://supermemory.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/supermemory/1szAHJ3-ym4bjQ4U/logo/light.svg?fit=max\u0026auto=format\u0026n=1szAHJ3-ym4bjQ4U\u0026q=85\u0026s=e4571d11b31900b962a200bf7206e7d9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://supermemory.ai/docs#website\",\"name\":\"supermemory | Memory API for the AI era\",\"url\":\"https://supermemory.ai/docs\",\"publisher\":{\"@id\":\"https://supermemory.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://supermemory.ai/docs/api-reference/profiles#webpage\",\"url\":\"https://supermemory.ai/docs/api-reference/profiles\",\"name\":\"Profiles\",\"description\":\"Static and dynamic facts about an entity, scoped to a container.\",\"dateModified\":\"2026-09-30T00:27:35.707Z\",\"isPartOf\":{\"@id\":\"https://supermemory.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://supermemory.ai/docs/api-reference/profiles#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://supermemory.ai/docs/api-reference/profiles#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recall\",\"item\":\"https://supermemory.ai/docs/api-reference/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Profiles\",\"item\":\"https://supermemory.ai/docs/api-reference/profiles\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://supermemory.ai/docs/api-reference/profiles#article\",\"headline\":\"Profiles\",\"name\":\"Profiles\",\"description\":\"Static and dynamic facts about an entity, scoped to a container.\",\"url\":\"https://supermemory.ai/docs/api-reference/profiles\",\"mainEntityOfPage\":{\"@id\":\"https://supermemory.ai/docs/api-reference/profiles#webpage\"},\"dateModified\":\"2026-09-30T00:27:35.707Z\",\"publisher\":{\"@id\":\"https://supermemory.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://supermemory.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"supermemory | Memory API for the AI era\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"supermemory | Memory API for the AI era","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"Developer platform","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/source-code.svg","anchors":[{"anchor":"Developer platform (API)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","pages":[{"title":"Developer platform (API)","href":"/overview/what-is-supermemory"}]},{"anchor":"API integrations","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-01.svg","pages":[{"title":"API integrations","href":"/integrations/supermemory-sdk"}]},{"anchor":"API reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-socket.svg","versions":[{"version":"Legacy (v3, v4)","pages":[{"title":"API reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-socket.svg","href":"/api-reference/overview"},{"title":"API keys \u0026 auth","sidebarTitle":"API keys","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/key-01.svg","href":"/authentication"},{"group":"Ingest","icon":"/icons/hugeicons/download-01.svg","pages":[{"title":"Ingest","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/ingest"},{"title":"Add document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents","href":"/api-reference/ingest/add-document"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents/file","href":"/api-reference/ingest/upload-a-file"},{"title":"Batch add documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents/batch","href":"/api-reference/ingest/batch-add-documents"},{"title":"Ingest or update conversation","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/conversations","href":"/api-reference/ingest/ingest-or-update-conversation"},{"title":"Get document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/{id}","href":"/api-reference/documents/get-document"}]},{"group":"Recall","icon":"/icons/hugeicons/search-01.svg","pages":[{"title":"Recall","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/search"},{"title":"Search memory entries","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/search","href":"/api-reference/recall-search/search-memory-entries"},{"title":"Search documents","description":"Search memories with advanced filtering","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/search","href":"/api-reference/documents/search-documents"},{"title":"Profiles","sidebarTitle":"Profiles overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/id.svg","href":"/api-reference/profiles"},{"title":"Get user profile","description":"Get user profile with optional search results","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/profile","href":"/api-reference/profiles/get-user-profile"},{"title":"Get profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/profile/buckets","href":"/api-reference/profiles/get-profile-buckets"}]},{"group":"Documents","icon":"/icons/hugeicons/file-02.svg","pages":[{"title":"Documents","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/documents"},{"title":"List documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents/list","href":"/api-reference/documents/list-documents"},{"title":"Get processing documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/processing","href":"/api-reference/documents/get-processing-documents"},{"title":"Update document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v3/documents/{id}","href":"/api-reference/ingest/update-document"},{"title":"Delete document by ID or customId","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/documents/{id}","href":"/api-reference/ingest/delete-document-by-id-or-customid"},{"title":"Bulk delete documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/documents/bulk","href":"/api-reference/ingest/bulk-delete-documents"},{"title":"Get document chunks","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/{id}/chunks","href":"/api-reference/documents/get-document-chunks"},{"title":"Get presigned file URL","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/{id}/file-url","href":"/api-reference/documents/get-presigned-file-url"}]},{"group":"Memories","icon":"/icons/hugeicons/database-01.svg","pages":[{"title":"Memories","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/memories"},{"title":"Create memories directly","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/memories","href":"/api-reference/content-management/create-memories-directly"},{"title":"List memory entries with history","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/memories/list","href":"/api-reference/content-management/list-memory-entries-with-history"},{"title":"Update a memory (creates new version)","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v4/memories","href":"/api-reference/content-management/update-a-memory-creates-new-version"},{"title":"Forget a memory","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v4/memories","href":"/api-reference/content-management/forget-a-memory"},{"title":"Forget memories matching a prompt/query","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/memories/forget-matching","href":"/api-reference/content-management/forget-memories-matching-a-promptquery"}]},{"group":"Container tags","icon":"/icons/hugeicons/tag-01.svg","pages":[{"title":"Container tags","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/container-tags"},{"title":"Get container tag settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/container-tags/{containerTag}","href":"/api-reference/container-tags/get-container-tag-settings"},{"title":"Update container tag settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v3/container-tags/{containerTag}","href":"/api-reference/container-tags/update-container-tag-settings"},{"title":"Delete container tag","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/container-tags/{containerTag}","href":"/api-reference/container-tags/delete-container-tag"},{"title":"Merge container tags","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/container-tags/merge","href":"/api-reference/container-tags/merge-container-tags"},{"title":"Get container tag merge status","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/container-tags/merge/{mergeId}","href":"/api-reference/container-tags/get-container-tag-merge-status"}]},{"group":"Connections","icon":"/icons/hugeicons/plug-01.svg","pages":[{"title":"Connections","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/connections"},{"title":"Create connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}","href":"/api-reference/connections/create-connection"},{"title":"List connections","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/list","href":"/api-reference/connections/list-connections"},{"title":"Get connection (by id)","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/connections/{connectionId}","href":"/api-reference/connections/get-connection-by-id"},{"title":"Configure connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{connectionId}/configure","href":"/api-reference/connections/configure-connection"},{"title":"Fetch resources","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/connections/{connectionId}/resources","href":"/api-reference/connections/fetch-resources"},{"title":"Sync connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}/import","href":"/api-reference/connections/sync-connection"},{"title":"List documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}/documents","href":"/api-reference/connections/list-documents"},{"title":"Get connection (by provider)","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}/connection","href":"/api-reference/connections/get-connection-by-provider"},{"title":"Delete connection by ID","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/connections/{connectionId}","href":"/api-reference/connections/delete-connection-by-id"},{"title":"Delete connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/connections/{provider}","href":"/api-reference/connections/delete-connection"}]},{"group":"Settings","icon":"/icons/hugeicons/settings-01.svg","pages":[{"title":"Settings","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/settings"},{"title":"Get settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/settings","href":"/api-reference/settings/get-settings"},{"title":"Update settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v3/settings","href":"/api-reference/settings/update-settings"},{"title":"Suggest profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/settings/suggest-buckets","href":"/api-reference/settings/suggest-profile-buckets"},{"title":"Reset organization data","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/settings/reset","href":"/api-reference/settings/reset-organization-data"}]},{"group":"Feedback","pages":[{"title":"Send feedback","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /feedback","href":"/api-reference/feedback/send-feedback"}]}]},{"version":"Latest (v5)","default":true,"pages":[{"title":"Latest (v5)","href":"/v5/api-reference/profiles"}]}]}]},{"tab":"Plugins and MCP","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/puzzle.svg","pages":[{"title":"Plugins and MCP","href":"/supermemory-mcp/mcp"}]}]},"title":"Profiles - supermemory | Memory API for the AI era","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":["10e4515597"],"chunks":["BannerMarkdown-EI3b4dIs.js","dist-C3vb5JQZ.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-C6CAjViH.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}