Profiles always contain static and dynamic sections, giving applications both durable knowledge and fresh context without composing them manually. Organization-owned buckets may be inherited but cannot be changed through namespace bucket endpoints.See profile migration.
Was this page helpful?
{"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":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afa5deb72bf2dcbf766bd53","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Developer platform","count":189},{"language":"default","tag":"API reference","count":91},{"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":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"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}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/supermemory/0ad5c1b8d894c2cb/style.css"}],"page":{"pagePath":"v5/api-reference/profiles","slug":"/v5/api-reference/profiles","pageMetadata":{"title":"Profiles","sidebarTitle":"Overview","description":"Turn accumulated memory into a ready-to-use understanding of a user","icon":"/icons/hugeicons/id.svg","href":"/v5/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: \"Turn accumulated memory into a ready-to-use understanding of a user\"\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`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Operation`}),_jsx(_components.th,{children:`Purpose`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /ns/{namespace}/profile`})}),_jsx(_components.td,{children:`Retrieve durable facts, recent context, and custom insights`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /ns/{namespace}/profile/buckets`})}),_jsx(_components.td,{children:`See the profile categories available here`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PUT /ns/{namespace}/profile/buckets`})}),_jsx(_components.td,{children:`Shape the profile with namespace-specific categories`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DELETE /ns/{namespace}/profile/buckets`})}),_jsx(_components.td,{children:`Remove namespace-specific categories`})]})]})]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`profile`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` supermemory.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#D2A8FF`},children:`profile`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"user_1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` supermemory.profiles.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#D2A8FF`},children:`setBuckets`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"user_1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` buckets: { work: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"Professional preferences and ongoing work\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`})`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`curl`,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"https://api.supermemory.ai/ns/user_1/profile\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`$SUPERMEMORY_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` '{}'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` PUT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"https://api.supermemory.ai/ns/user_1/profile/buckets\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`$SUPERMEMORY_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` '{\"buckets\":{\"work\":\"Professional preferences and ongoing work\"}}'`})]}),`\n`]})})})]}),`\n`,_jsx(_components.p,{children:`Profiles always contain static and dynamic sections, giving applications both durable knowledge and fresh context without composing them manually. Organization-owned buckets may be inherited but cannot be changed through namespace bucket endpoints.`}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/migration/api-v5-profiles`,children:`profile migration`}),`.`]})]})}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":"Overview","description":"Turn accumulated memory into a ready-to-use understanding of a user","icon":"/icons/hugeicons/id.svg","href":"/v5/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":"6ad122e1f69f2938fd7dbc48","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"How do I create custom buckets?","status":"active","generatedBy":"contextual","path":"v5/api-reference/profiles","createdAt":"2026-10-15T19:00:49.648Z","updatedAt":"2026-10-15T19:00:49.648Z","__v":0},{"_id":"6ad122e1f69f2938fd7dbc47","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"What are profile buckets?","status":"active","generatedBy":"contextual","path":"v5/api-reference/profiles","createdAt":"2026-10-15T19:00:49.648Z","updatedAt":"2026-10-15T19:00:49.648Z","__v":0},{"_id":"6ad122e1f69f2938fd7dbc46","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"How do I retrieve a user profile?","status":"active","generatedBy":"contextual","path":"v5/api-reference/profiles","createdAt":"2026-10-15T19:00:49.648Z","updatedAt":"2026-10-15T19:00:49.648Z","__v":0}],"navMaps":{"firstHrefInVersion":{"Legacy (v3, v4)":{"href":"/api-reference/profiles","matchLevel":1},"Latest (v5)":{"href":"/v5/api-reference/profiles","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-10-15T19:00:43.806Z","originalFileLocation":"v5/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=\"Turn accumulated memory into a ready-to-use understanding of a user\">\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=\"Turn accumulated memory into a ready-to-use understanding of a user\">\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/v5/api-reference/profiles\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://supermemory.mintlify.site/docs/_mintlify/api/og/v2?division=Profiles\u0026amp;title=Profiles\u0026amp;description=Turn+accumulated+memory+into+a+ready-to-use+understanding+of+a+user\u0026amp;theme=f0b184f649948bfd607431b4\u0026amp;signature=05edbd379987ec29bfe1c357f2411f59ff7aeb9fba8832a9428eeb64df5f23b0\">\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=\"Turn accumulated memory into a ready-to-use understanding of a user\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supermemory.mintlify.site/docs/_mintlify/api/og/v2?division=Profiles\u0026amp;title=Profiles\u0026amp;description=Turn+accumulated+memory+into+a+ready-to-use+understanding+of+a+user\u0026amp;theme=f0b184f649948bfd607431b4\u0026amp;signature=05edbd379987ec29bfe1c357f2411f59ff7aeb9fba8832a9428eeb64df5f23b0\">\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/v5/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/v5/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/v5/api-reference/profiles#webpage\",\"url\":\"https://supermemory.ai/docs/v5/api-reference/profiles\",\"name\":\"Profiles\",\"description\":\"Turn accumulated memory into a ready-to-use understanding of a user\",\"dateModified\":\"2026-10-15T19:00:43.806Z\",\"isPartOf\":{\"@id\":\"https://supermemory.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://supermemory.ai/docs/v5/api-reference/profiles#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://supermemory.ai/docs/v5/api-reference/profiles#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"supermemory | Memory API for the AI era\",\"item\":\"https://supermemory.ai/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Profiles\",\"item\":\"https://supermemory.ai/docs/v5/api-reference/profiles\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://supermemory.ai/docs/v5/api-reference/profiles#article\",\"headline\":\"Profiles\",\"name\":\"Profiles\",\"description\":\"Turn accumulated memory into a ready-to-use understanding of a user\",\"url\":\"https://supermemory.ai/docs/v5/api-reference/profiles\",\"mainEntityOfPage\":{\"@id\":\"https://supermemory.ai/docs/v5/api-reference/profiles#webpage\"},\"dateModified\":\"2026-10-15T19:00:43.806Z\",\"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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"supermemory | Memory API for the AI era\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/v5/api-reference/profiles.md","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":"Legacy (v3, v4)","href":"/api-reference/profiles"}]},{"version":"Latest (v5)","default":true,"pages":[{"title":"API reference","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-socket.svg","href":"/v5/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":"/v5/api-reference/ingest"},{"title":"Add document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/document","href":"/v5/api-reference/ingest/add-document"},{"title":"Batch add documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/document/batch","href":"/v5/api-reference/ingest/batch-add-documents"},{"title":"Upload file","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/document/file","href":"/v5/api-reference/ingest/upload-file"},{"title":"Update document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi patch /ns/{namespace}/document/{id}","href":"/v5/api-reference/ingest/update-document"},{"title":"Replace document with file","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/document/file/{id}","href":"/v5/api-reference/ingest/replace-document-with-file"},{"title":"Partially update document file","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi patch /ns/{namespace}/document/file/{id}","href":"/v5/api-reference/ingest/partially-update-document-file"}]},{"group":"Content Management","icon":"/icons/hugeicons/file-02.svg","pages":[{"title":"Content management","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/v5/api-reference/content-management"},{"title":"Get document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /ns/{namespace}/document/{id}","href":"/v5/api-reference/content-management/get-document"},{"title":"Get memory","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /ns/{namespace}/memories/{id}","href":"/v5/api-reference/content-management/get-memory"},{"title":"List resources","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/list/{type}","href":"/v5/api-reference/content-management/list-resources"},{"title":"Delete documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi delete /ns/{namespace}/document","href":"/v5/api-reference/content-management/delete-documents"},{"title":"Forget memories by ID","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi delete /ns/{namespace}/memories","href":"/v5/api-reference/content-management/forget-memories-by-id"},{"title":"Forget memories semantically","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi delete /ns/{namespace}/memories/semantic","href":"/v5/api-reference/content-management/forget-memories-semantically"}]},{"group":"Search","icon":"/icons/hugeicons/search-01.svg","pages":[{"title":"Search","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/v5/api-reference/search"},{"title":"Search memories","description":"Recall the most relevant learned context and source passages from a namespace. Hybrid search combines memories with document chunks by default, with optional query rewriting, reranking, and supporting context attachments.","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/search","href":"/v5/api-reference/recall-search/search-memories"}]},{"group":"Profiles","icon":"/icons/hugeicons/id.svg","pages":[{"title":"Profiles","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/id.svg","href":"/v5/api-reference/profiles"},{"title":"Get profile","description":"Read a continuously maintained understanding of the subject represented by this namespace. Stable facts, evolving context, and selected custom buckets are returned together without requiring a search query.","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/profile","href":"/v5/api-reference/profiles/get-profile"},{"title":"Get profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /ns/{namespace}/profile/buckets","href":"/v5/api-reference/profiles/get-profile-buckets"},{"title":"Add or update profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi put /ns/{namespace}/profile/buckets","href":"/v5/api-reference/profiles/add-or-update-profile-buckets"},{"title":"Delete profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi delete /ns/{namespace}/profile/buckets","href":"/v5/api-reference/profiles/delete-profile-buckets"}]},{"group":"Namespaces","icon":"/icons/hugeicons/layers-01.svg","pages":[{"title":"Namespaces","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/v5/api-reference/namespaces"},{"title":"List namespaces","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /namespaces","href":"/v5/api-reference/namespaces/list-namespaces"},{"title":"Get namespace settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /ns/{namespace}","href":"/v5/api-reference/namespaces/get-namespace-settings"},{"title":"Update namespace settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi patch /ns/{namespace}","href":"/v5/api-reference/namespaces/update-namespace-settings"},{"title":"Delete namespace","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi delete /ns/{namespace}","href":"/v5/api-reference/namespaces/delete-namespace"}]},{"group":"Connectors","icon":"/icons/hugeicons/plug-01.svg","pages":[{"title":"Connectors","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/v5/api-reference/connectors"},{"title":"Create connector","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/connectors","href":"/v5/api-reference/connectors/create-connector"},{"title":"List connectors","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /ns/{namespace}/connectors","href":"/v5/api-reference/connectors/list-connectors"},{"title":"Get connector","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /ns/{namespace}/connectors/{id}","href":"/v5/api-reference/connectors/get-connector"},{"title":"Update connector","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi patch /ns/{namespace}/connectors/{id}","href":"/v5/api-reference/connectors/update-connector"},{"title":"Sync connector","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /ns/{namespace}/connectors/{id}/sync","href":"/v5/api-reference/connectors/sync-connector"},{"title":"Delete connector","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi delete /ns/{namespace}/connectors/{id}","href":"/v5/api-reference/connectors/delete-connector"},{"title":"List all connectors","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /connectors","href":"/v5/api-reference/connectors/list-all-connectors"}]},{"group":"Organization","icon":"/icons/hugeicons/building-03.svg","pages":[{"title":"Organization","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/v5/api-reference/organization"},{"title":"Get organization settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi get /organization","href":"/v5/api-reference/organization/get-organization-settings"},{"title":"Update organization settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi patch /organization","href":"/v5/api-reference/organization/update-organization-settings"}]},{"group":"Feedback","pages":[{"title":"Send feedback","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v5/openapi post /feedback","href":"/v5/api-reference/feedback/send-feedback"}]}]}]}]},{"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"}]}]},"basePath":"","title":"Profiles - supermemory | Memory API for the AI era","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["10e4515597"],"chunks":["BannerMarkdown-L4KFxIos.js","dist-B0ZV6X5T.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-B6IZIRsp.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}