{
"profile": {
"static": [
"<string>"
],
"dynamic": [
"<string>"
],
"buckets": {}
},
"searchResults": {
"results": [
{
"id": "mem_abc123",
"metadata": {
"source": "conversation",
"confidence": 0.9
},
"updatedAt": "<string>",
"similarity": 0.89,
"memory": "The user prefers detailed API responses over minimal ones.",
"chunk": "This is a chunk of content from a document...",
"filepath": "<string>",
"version": 3,
"rootMemoryId": "mem_abc123",
"context": {
"parents": [
{
"id": "<string>",
"relation": "updates",
"memory": "Earlier version: API rate limit is 50 req/min on the free tier.",
"updatedAt": "<string>",
"version": -1,
"metadata": {}
}
],
"children": [
{
"id": "<string>",
"relation": "extends",
"memory": "Later version: API rate limit increased to 100 req/min on the free tier.",
"updatedAt": "<string>",
"version": 1,
"metadata": {}
}
],
"related": [
{
"id": "<string>",
"relation": "extends",
"memory": "<string>",
"updatedAt": "<string>",
"metadata": {}
}
]
},
"documents": [
{
"id": "doc_xyz789",
"createdAt": "<string>",
"updatedAt": "<string>",
"title": "API Rate Limiting Policy",
"type": "web",
"metadata": {
"source": "upload",
"language": "en"
},
"summary": "API rate limit policy: 100 req/min free, 1000 req/min pro."
}
],
"chunks": [
{
"content": "This is a chunk of content from the document...",
"position": 0,
"documentId": "doc_xyz789"
}
],
"isAggregated": false
}
],
"total": 123,
"timing": 123
}
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
containerTag
string
required
Tag to filter the profile by. This can be an ID for your user, a project ID, or any other identifier you wish to use to filter memories.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9_:-]+$
q
string
Optional search query to include search results in the response
threshold
number
Threshold for search results. Only results with a score above this threshold will be included.
Required range: 0 <= x <= 1
filters
object
Optional metadata filters to apply to profile results and search results. Supports complex AND/OR queries with multiple conditions.
Option 1
Option 2
Show child attributes
include
enum<string>[]
Profile sections to return. Omit to return all sections. Pass a subset to reduce payload — e.g. ["buckets"] skips static and dynamic entirely.
Available options:
static,
dynamic,
buckets
buckets
string[]
Specific bucket keys to return. Omit to return all configured buckets. Only relevant when "buckets" is included.
Response
User profile with optional search results
profile
object
required
Show child attributes
searchResults
object
Search results if a search query was provided
Show child attributes
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":"6afd1afc4aead03cc72c1b18","clientVersion":"0.0.4227","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","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":"api-reference/profiles/get-user-profile","slug":"/api-reference/profiles/get-user-profile","pageMetadata":{"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","autogeneratedByOpenApi":true},"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: \"Get user profile with optional search results\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"config":{},"pageMetadata":{"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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/supermemory/71b914845a04a595/theme-switch.js"],"openApiReferenceData":{"operation":{"operationId":"postV4Profile","description":"Get user profile with optional search results","responses":{"200":"a051bc4f-dd87-492a-a4ae-afe7acd03107","400":"3478e331-506b-4951-8657-e08dab2d9dd4","401":"d37cf180-4534-4e83-b9d6-d084a669cd46","402":"6a2b7dd9-fd2d-4457-ad66-a9aa30da3865","500":"f209f139-5e1c-4f8c-9c33-774158f6dc74"},"summary":"Get user profile","tags":["Profiles"],"requestBody":"e2c1e046-a259-44c3-8e2a-4b9307c874af","x-codeSamples":[{"lang":"typescript","label":"TypeScript SDK","source":"import Supermemory from \"supermemory\";\n\nconst client = new Supermemory({\n apiKey: process.env.SUPERMEMORY_API_KEY,\n});\n\nconst { profile } = await client.profile({\n containerTag: \"user_123\",\n});\n\nconsole.log(profile.static); // long-term facts\nconsole.log(profile.dynamic); // recent context"},{"lang":"python","label":"Python SDK","source":"from supermemory import Supermemory\n\nclient = Supermemory() # uses SUPERMEMORY_API_KEY\n\nresult = client.profile(container_tag=\"user_123\")\nprint(result.profile.static)\nprint(result.profile.dynamic)"},{"lang":"bash","label":"cURL","source":"curl -X POST \"https://api.supermemory.ai/v4/profile\" \\\n -H \"Authorization: Bearer $SUPERMEMORY_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"containerTag\": \"user_123\" }'"}],"method":"post","type":"path","servers":["001dcd81-a783-4cbb-8e87-42d08573ab56"],"security":["86ef9429-c1ae-49e3-a7d5-72abd7c573b1"],"path":"/v4/profile","baseUrlOptions":["https://api.supermemory.ai"],"title":"Get user profile","codeSamples":[{"label":"TypeScript SDK","lang":"typescript","source":"import Supermemory from \"supermemory\";\n\nconst client = new Supermemory({\n apiKey: process.env.SUPERMEMORY_API_KEY,\n});\n\nconst { profile } = await client.profile({\n containerTag: \"user_123\",\n});\n\nconsole.log(profile.static); // long-term facts\nconsole.log(profile.dynamic); // recent context"},{"label":"Python SDK","lang":"python","source":"from supermemory import Supermemory\n\nclient = Supermemory() # uses SUPERMEMORY_API_KEY\n\nresult = client.profile(container_tag=\"user_123\")\nprint(result.profile.static)\nprint(result.profile.dynamic)"},{"label":"cURL","lang":"bash","source":"curl -X POST \"https://api.supermemory.ai/v4/profile\" \\\n -H \"Authorization: Bearer $SUPERMEMORY_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{ \"containerTag\": \"user_123\" }'"}],"requestExampleLanguages":["typescript","python","bash"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.containerTag":"\u003cstring>","body.q":"\u003cstring>","body.threshold":0.5,"body.filters.oneOf.0.OR.items.0.oneOf.0.key":"\u003cstring>","body.filters.oneOf.0.OR.items.0.oneOf.0.value":"\u003cstring>","body.filters.oneOf.0.OR.items.0.oneOf.0.filterType":"metadata","body.filters.oneOf.0.OR.items.0.oneOf.0.negate.oneOf.0":true,"body.filters.oneOf.0.OR.items.0.oneOf.0.ignoreCase.oneOf.0":true,"body.filters.oneOf.0.OR.items.0.oneOf.0.numericOperator":"=","body.buckets.items.0":"\u003cstring>"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"containerTag":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9_:-]+$","description":"Tag to filter the profile by. This can be an ID for your user, a project ID, or any other identifier you wish to use to filter memories.","isRequired":true,"uniqueKey":"containerTag","typeLabel":"string"},"q":{"description":"Optional search query to include search results in the response","type":"string","uniqueKey":"q","typeLabel":"string"},"threshold":{"description":"Threshold for search results. Only results with a score above this threshold will be included.","type":"number","minimum":0,"maximum":1,"uniqueKey":"threshold","typeLabel":"number"},"filters":{"oneOf":[{"type":"object","description":"Optional metadata filters to apply to profile results and search results. Supports complex AND/OR queries with multiple conditions.","required":["OR"],"properties":{"OR":{"type":"array","items":{"oneOf":[{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.key","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.value","typeLabel":"string"},"filterType":{"default":"metadata","type":"string","enum":["metadata","numeric","array_contains","string_contains"],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.filterType","typeLabel":"enum\u003cstring>"},"negate":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.negate.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.negate.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.negate","typeLabel":"boolean | enum\u003cstring>"},"ignoreCase":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.ignoreCase.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.ignoreCase.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.ignoreCase","typeLabel":"boolean | enum\u003cstring>"},"numericOperator":{"default":"=","type":"string","enum":[">","\u003c",">=","\u003c=","="],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.numericOperator","typeLabel":"enum\u003cstring>"}},"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["OR"],"properties":{"OR":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"OR: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.1.OR","typeLabel":"array"}},"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["AND"],"properties":{"AND":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"AND: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.2.AND","typeLabel":"array"}},"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX]","typeLabel":"object"},"description":"Array of OR filter expressions","isRequired":true,"uniqueKey":"filters.oneOf.0.OR","typeLabel":"object[]"}},"uniqueKey":"filters.oneOf.0","typeLabel":"object"},{"type":"object","description":"Optional metadata filters to apply to profile results and search results. Supports complex AND/OR queries with multiple conditions.","required":["AND"],"properties":{"AND":{"type":"array","items":{"oneOf":[{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.key","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.value","typeLabel":"string"},"filterType":{"default":"metadata","type":"string","enum":["metadata","numeric","array_contains","string_contains"],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.filterType","typeLabel":"enum\u003cstring>"},"negate":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.negate.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.negate.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.negate","typeLabel":"boolean | enum\u003cstring>"},"ignoreCase":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.ignoreCase.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.ignoreCase.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.ignoreCase","typeLabel":"boolean | enum\u003cstring>"},"numericOperator":{"default":"=","type":"string","enum":[">","\u003c",">=","\u003c=","="],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.numericOperator","typeLabel":"enum\u003cstring>"}},"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["OR"],"properties":{"OR":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"OR: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.1.OR","typeLabel":"array"}},"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["AND"],"properties":{"AND":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"AND: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.2.AND","typeLabel":"array"}},"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX]","typeLabel":"object"},"description":"Array of AND filter expressions","isRequired":true,"uniqueKey":"filters.oneOf.1.AND","typeLabel":"object[]"}},"uniqueKey":"filters.oneOf.1","typeLabel":"object"}],"uniqueKey":"filters","typeLabel":"object"},"include":{"description":"Profile sections to return. Omit to return all sections. Pass a subset to reduce payload — e.g. [\"buckets\"] skips static and dynamic entirely.","type":"array","items":{"type":"string","enum":["static","dynamic","buckets"],"uniqueKey":"include.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"include","typeLabel":"enum\u003cstring>[]"},"buckets":{"description":"Specific bucket keys to return. Omit to return all configured buckets. Only relevant when \"buckets\" is included.","type":"array","items":{"type":"string","uniqueKey":"buckets.items.[INDEX]","typeLabel":"string"},"uniqueKey":"buckets","typeLabel":"string[]"}},"required":["containerTag"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"containerTag":"\u003cstring>","q":"\u003cstring>","threshold":0.5,"filters":{"OR":[{"key":"\u003cstring>","value":"\u003cstring>","filterType":"metadata","negate":true,"ignoreCase":true,"numericOperator":"="}]},"include":[],"buckets":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a051bc4f-dd87-492a-a4ae-afe7acd03107":{"content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"static":{"description":"Static profile information that remains relevant long-term","type":"array","items":{"type":"string","uniqueKey":"profile.static.items.[INDEX]","typeLabel":"string"},"uniqueKey":"profile.static","typeLabel":"string[]"},"dynamic":{"description":"Dynamic profile information (recent memories)","type":"array","items":{"type":"string","uniqueKey":"profile.dynamic.items.[INDEX]","typeLabel":"string"},"uniqueKey":"profile.dynamic","typeLabel":"string[]"},"buckets":{"description":"Per-bucket memory lists, keyed by bucket key","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"profile.buckets.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"profile.buckets.additionalProperties","typeLabel":"string[]"},"uniqueKey":"profile.buckets","typeLabel":"object"}},"isRequired":true,"uniqueKey":"profile","typeLabel":"object"},"searchResults":{"description":"Search results if a search query was provided","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Memory entry ID or chunk ID","example":"mem_abc123","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].id","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","description":"Memory metadata","example":{"source":"conversation","confidence":0.9},"additionalProperties":{"oneOf":[{}],"uniqueKey":"searchResults.results.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Memory metadata","example":{"source":"conversation","confidence":0.9},"isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].metadata","typeLabel":"object | null"},"updatedAt":{"type":"string","description":"Memory last update date","format":"datetime","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].updatedAt","typeLabel":"string\u003cdatetime>"},"similarity":{"type":"number","description":"Similarity score between the query and memory entry","example":0.89,"maximum":1,"minimum":0,"isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].similarity","typeLabel":"number"},"memory":{"description":"The memory content (only present for memory results)","example":"The user prefers detailed API responses over minimal ones.","type":"string","uniqueKey":"searchResults.results.items.[INDEX].memory","typeLabel":"string"},"chunk":{"description":"The chunk content (only present for chunk results from hybrid search)","example":"This is a chunk of content from a document...","type":"string","uniqueKey":"searchResults.results.items.[INDEX].chunk","typeLabel":"string"},"filepath":{"oneOf":[{"description":"Filepath of the source document this memory or chunk came from","x-hidden":true,"type":"string","uniqueKey":"searchResults.results.items.[INDEX].filepath.oneOf.0","typeLabel":"string"},{"description":"Filepath of the source document this memory or chunk came from","x-hidden":true,"type":"null","uniqueKey":"searchResults.results.items.[INDEX].filepath.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].filepath","typeLabel":"string | null"},"version":{"oneOf":[{"description":"Version number of this memory entry","example":3,"type":"number","uniqueKey":"searchResults.results.items.[INDEX].version.oneOf.0","typeLabel":"number"},{"description":"Version number of this memory entry","example":3,"type":"null","uniqueKey":"searchResults.results.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].version","typeLabel":"number | null"},"rootMemoryId":{"oneOf":[{"description":"ID of the root (first version) memory entry this one descends from. Null for memories that have never been superseded. Only present on memory results, not on standalone chunk results.","example":"mem_abc123","type":"string","uniqueKey":"searchResults.results.items.[INDEX].rootMemoryId.oneOf.0","typeLabel":"string"},{"description":"ID of the root (first version) memory entry this one descends from. Null for memories that have never been superseded. Only present on memory results, not on standalone chunk results.","example":"mem_abc123","type":"null","uniqueKey":"searchResults.results.items.[INDEX].rootMemoryId.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].rootMemoryId","typeLabel":"string | null"},"context":{"description":"Object containing version history (parents/children via updates) and related memories (extends/derives)","type":"object","properties":{"parents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Related memory ID","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].id","typeLabel":"string"},"relation":{"type":"string","enum":["updates","extends","derives"],"description":"Relation type between this memory and its parent/child","example":"updates","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].relation","typeLabel":"enum\u003cstring>"},"memory":{"type":"string","description":"The contextual memory content","example":"Earlier version: API rate limit is 50 req/min on the free tier.","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].memory","typeLabel":"string"},"updatedAt":{"type":"string","description":"Contextual memory last update date","format":"datetime","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].updatedAt","typeLabel":"string\u003cdatetime>"},"version":{"oneOf":[{"description":"Relative version distance from the primary memory (-1 for direct parent, -2 for grand-parent, etc.)","example":-1,"type":"number","uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].version.oneOf.0","typeLabel":"number"},{"description":"Relative version distance from the primary memory (-1 for direct parent, -2 for grand-parent, etc.)","example":-1,"type":"null","uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].version","typeLabel":"number | null"},"metadata":{"oneOf":[{"type":"object","description":"Contextual memory metadata","additionalProperties":{"oneOf":[{}],"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Contextual memory metadata","uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX].metadata","typeLabel":"object | null"}},"required":["id","relation","memory","updatedAt"],"uniqueKey":"searchResults.results.items.[INDEX].context.parents.items.[INDEX]","typeLabel":"object"},"uniqueKey":"searchResults.results.items.[INDEX].context.parents","typeLabel":"object[]"},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Related memory ID","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].id","typeLabel":"string"},"relation":{"type":"string","enum":["updates","extends","derives"],"description":"Relation type between this memory and its parent/child","example":"extends","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].relation","typeLabel":"enum\u003cstring>"},"memory":{"type":"string","description":"The contextual memory content","example":"Later version: API rate limit increased to 100 req/min on the free tier.","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].memory","typeLabel":"string"},"updatedAt":{"type":"string","description":"Contextual memory last update date","format":"datetime","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].updatedAt","typeLabel":"string\u003cdatetime>"},"version":{"oneOf":[{"description":"Relative version distance from the primary memory (+1 for direct child, +2 for grand-child, etc.)","example":1,"type":"number","uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].version.oneOf.0","typeLabel":"number"},{"description":"Relative version distance from the primary memory (+1 for direct child, +2 for grand-child, etc.)","example":1,"type":"null","uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].version.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].version","typeLabel":"number | null"},"metadata":{"oneOf":[{"type":"object","description":"Contextual memory metadata","additionalProperties":{"oneOf":[{}],"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Contextual memory metadata","uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX].metadata","typeLabel":"object | null"}},"required":["id","relation","memory","updatedAt"],"uniqueKey":"searchResults.results.items.[INDEX].context.children.items.[INDEX]","typeLabel":"object"},"uniqueKey":"searchResults.results.items.[INDEX].context.children","typeLabel":"object[]"},"related":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Related memory ID","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].id","typeLabel":"string"},"relation":{"type":"string","enum":["extends","derives"],"description":"Relation type","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].relation","typeLabel":"enum\u003cstring>"},"memory":{"type":"string","description":"The related memory content","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].memory","typeLabel":"string"},"updatedAt":{"type":"string","description":"Related memory last update date","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].updatedAt","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","description":"Related memory metadata","additionalProperties":{"oneOf":[{}],"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Related memory metadata","uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX].metadata","typeLabel":"object | null"}},"required":["id","relation","memory","updatedAt"],"uniqueKey":"searchResults.results.items.[INDEX].context.related.items.[INDEX]","typeLabel":"object"},"uniqueKey":"searchResults.results.items.[INDEX].context.related","typeLabel":"object[]"}},"uniqueKey":"searchResults.results.items.[INDEX].context","typeLabel":"object"},"documents":{"description":"Associated documents for this memory entry","type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Document ID","example":"doc_xyz789","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].id","typeLabel":"string"},"createdAt":{"type":"string","description":"Document creation date","format":"datetime","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].createdAt","typeLabel":"string\u003cdatetime>"},"updatedAt":{"type":"string","description":"Document last update date","format":"datetime","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].updatedAt","typeLabel":"string\u003cdatetime>"},"title":{"description":"Document title (only included when documents=true)","example":"API Rate Limiting Policy","type":"string","uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].title","typeLabel":"string"},"type":{"description":"Document type (only included when documents=true)","example":"web","type":"string","uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].type","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","description":"Document metadata (only included when documents=true)","example":{"source":"upload","language":"en"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Document metadata (only included when documents=true)","example":{"source":"upload","language":"en"},"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].metadata","typeLabel":"object | null"},"summary":{"oneOf":[{"description":"Document summary (only included when summaries=true)","example":"API rate limit policy: 100 req/min free, 1000 req/min pro.","type":"string","uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"description":"Document summary (only included when summaries=true)","example":"API rate limit policy: 100 req/min free, 1000 req/min pro.","type":"null","uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX].summary","typeLabel":"string | null"}},"required":["id","createdAt","updatedAt"],"uniqueKey":"searchResults.results.items.[INDEX].documents.items.[INDEX]","typeLabel":"object"},"uniqueKey":"searchResults.results.items.[INDEX].documents","typeLabel":"object[]"},"chunks":{"description":"Relevant chunks from associated documents (only included when chunks=true)","type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"Content of the chunk","example":"This is a chunk of content from the document...","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].chunks.items.[INDEX].content","typeLabel":"string"},"position":{"type":"number","description":"Position of chunk in the document (0-indexed)","example":0,"isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].chunks.items.[INDEX].position","typeLabel":"number"},"documentId":{"type":"string","description":"ID of the document this chunk belongs to","example":"doc_xyz789","isRequired":true,"uniqueKey":"searchResults.results.items.[INDEX].chunks.items.[INDEX].documentId","typeLabel":"string"}},"required":["content","position","documentId"],"uniqueKey":"searchResults.results.items.[INDEX].chunks.items.[INDEX]","typeLabel":"object"},"uniqueKey":"searchResults.results.items.[INDEX].chunks","typeLabel":"object[]"},"isAggregated":{"description":"Indicates if this memory was created by aggregating multiple source memories","example":false,"type":"boolean","uniqueKey":"searchResults.results.items.[INDEX].isAggregated","typeLabel":"boolean"}},"required":["id","metadata","updatedAt","similarity"],"uniqueKey":"searchResults.results.items.[INDEX]","typeLabel":"object"},"description":"Search results for the provided query","isRequired":true,"uniqueKey":"searchResults.results","typeLabel":"object[]"},"total":{"type":"number","description":"Total number of search results","isRequired":true,"uniqueKey":"searchResults.total","typeLabel":"number"},"timing":{"type":"number","description":"Search timing in milliseconds","isRequired":true,"uniqueKey":"searchResults.timing","typeLabel":"number"}},"required":["results","total","timing"],"uniqueKey":"searchResults","typeLabel":"object"}},"required":["profile"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"profile":{"static":["\u003cstring>"],"dynamic":["\u003cstring>"],"buckets":{}},"searchResults":{"results":[{"id":"mem_abc123","metadata":{"source":"conversation","confidence":0.9},"updatedAt":"\u003cstring>","similarity":0.89,"memory":"The user prefers detailed API responses over minimal ones.","chunk":"This is a chunk of content from a document...","filepath":"\u003cstring>","version":3,"rootMemoryId":"mem_abc123","context":{"parents":[{"id":"\u003cstring>","relation":"updates","memory":"Earlier version: API rate limit is 50 req/min on the free tier.","updatedAt":"\u003cstring>","version":-1,"metadata":{}}],"children":[{"id":"\u003cstring>","relation":"extends","memory":"Later version: API rate limit increased to 100 req/min on the free tier.","updatedAt":"\u003cstring>","version":1,"metadata":{}}],"related":[{"id":"\u003cstring>","relation":"extends","memory":"\u003cstring>","updatedAt":"\u003cstring>","metadata":{}}]},"documents":[{"id":"doc_xyz789","createdAt":"\u003cstring>","updatedAt":"\u003cstring>","title":"API Rate Limiting Policy","type":"web","metadata":{"source":"upload","language":"en"},"summary":"API rate limit policy: 100 req/min free, 1000 req/min pro."}],"chunks":[{"content":"This is a chunk of content from the document...","position":0,"documentId":"doc_xyz789"}],"isAggregated":false}],"total":123,"timing":123}}}},"exampleType":"generated"}},"description":"User profile with optional search results","exampleType":"generated"},"3478e331-506b-4951-8657-e08dab2d9dd4":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Invalid request parameters","exampleType":"generated"},"d37cf180-4534-4e83-b9d6-d084a669cd46":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"6a2b7dd9-fd2d-4457-ad66-a9aa30da3865":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Search quota or credits exhausted (when search query is provided)","exampleType":"generated"},"f209f139-5e1c-4f8c-9c33-774158f6dc74":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Server error","exampleType":"generated"}},"security":{"86ef9429-c1ae-49e3-a7d5-72abd7c573b1":{"bearerAuth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"001dcd81-a783-4cbb-8e87-42d08573ab56":{"description":"Production Server","url":"https://api.supermemory.ai"}},"schemas":{"82064fa3-2df4-4ded-9615-029c7d3b0813":{"oneOf":[{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true},"value":{"type":"string","isRequired":true},"filterType":{"default":"metadata","type":"string","enum":["metadata","numeric","array_contains","string_contains"]},"negate":{"oneOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"ignoreCase":{"oneOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"numericOperator":{"default":"=","type":"string","enum":[">","\u003c",">=","\u003c=","="]}}},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["OR"],"properties":{"OR":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"OR: Array of conditions or nested expressions","isRequired":true}}},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["AND"],"properties":{"AND":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"AND: Array of conditions or nested expressions","isRequired":true}}}]}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.supermemory.ai/v4/openapi"},"subdomain":"supermemory","siteName":"supermemory | Memory API for the AI era","title":"Get user profile - supermemory | Memory API for the AI era","contextualStarterQuestions":[{"_id":"69e95e74c82b27b92a35aaa9","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"How do I get a user profile?","status":"active","generatedBy":"contextual","path":"api-reference/profiles/get-user-profile","createdAt":"2026-04-22T23:49:08.350Z","updatedAt":"2026-04-22T23:49:08.350Z","__v":0},{"_id":"69e95e74c82b27b92a35aaaa","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"Can I include search results?","status":"active","generatedBy":"contextual","path":"api-reference/profiles/get-user-profile","createdAt":"2026-04-22T23:49:08.350Z","updatedAt":"2026-04-22T23:49:08.350Z","__v":0},{"_id":"69e95e74c82b27b92a35aaab","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"What parameters are required?","status":"active","generatedBy":"contextual","path":"api-reference/profiles/get-user-profile","createdAt":"2026-04-22T23:49:08.350Z","updatedAt":"2026-04-22T23:49:08.350Z","__v":0}],"navMaps":{"firstHrefInVersion":{"Legacy (v3, v4)":{"href":"/api-reference/profiles/get-user-profile","matchLevel":0},"Latest (v5)":{"href":"/v5/api-reference/overview","matchLevel":3}},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T18:43:18.238Z","originalFileLocation":"api-reference/profiles/get-user-profile.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=\"Get user profile with optional search results\">\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=\"Get user profile - supermemory | Memory API for the AI era\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get user profile with optional search results\">\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/get-user-profile\">\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=Recall\u0026amp;title=Get+user+profile\u0026amp;description=Get+user+profile+with+optional+search+results\u0026amp;theme=f0b184f649948bfd607431b4\u0026amp;signature=116266a181a50f189329555a74121bae9950be1f883f71be7d5ab86a8c05b610\">\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=\"Get user profile - supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get user profile with optional search results\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supermemory.mintlify.site/docs/_mintlify/api/og/v2?division=Recall\u0026amp;title=Get+user+profile\u0026amp;description=Get+user+profile+with+optional+search+results\u0026amp;theme=f0b184f649948bfd607431b4\u0026amp;signature=116266a181a50f189329555a74121bae9950be1f883f71be7d5ab86a8c05b610\">\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/get-user-profile\">\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/get-user-profile.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/get-user-profile#webpage\",\"url\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile\",\"name\":\"Get user profile\",\"description\":\"Get user profile with optional search results\",\"dateModified\":\"2026-11-02T18:43:18.238Z\",\"isPartOf\":{\"@id\":\"https://supermemory.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recall\",\"item\":\"https://supermemory.ai/docs/api-reference/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get user profile\",\"item\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile#apireference\",\"headline\":\"Get user profile\",\"name\":\"Get user profile\",\"description\":\"Get user profile with optional search results\",\"url\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile\",\"mainEntityOfPage\":{\"@id\":\"https://supermemory.ai/docs/api-reference/profiles/get-user-profile#webpage\"},\"dateModified\":\"2026-11-02T18:43:18.238Z\",\"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/api-reference/profiles/get-user-profile.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":"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","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","description":"Static and dynamic facts about an entity, scoped to a container.","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/id.svg","href":"/api-reference/profiles"},{"title":"Get user profile","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","description":"Returns the effective profile bucket definitions for a given container tag — org-level buckets merged with any container-tag-level additions.","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":"List all container tags","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/container-tags/list","href":"/api-reference/container-tags/list-all-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/overview"}]}]}]},{"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":"Get user profile - supermemory | Memory API for the AI era","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-c3oKHz6v.js","dist-CLdzWocy.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DyP0AOE1.js","snippetPresets-CuYPAUIG.js","utils-ez5j6NBT.js","style-to-object-BY3JEAdk.js","utils-DG4aeUOF.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DFhcMUrP.js","conditional-requirements-CFM0id0Q.js","cloneDeep-ByDTqllG.js","_Uint8Array-CJ2WjX_H.js","isObject-FP1Yky1u.js","ApiExamples-fyn9sMD9.js","usePlaygroundInputsStore-Bf0N_Y6L.js","shallow-CnU26VTn.js","isEqual-OWIKZzop.js","CodeSnippets-CZ9-M31v.js","CodeSnippet-CCk6UVRR.js","getApiPlaygroundDisplay-BUw5JwZB.js","Page-CInwEL5w.js","DynamicMarkdown-CU5QIokU.js","SectionHeading-BoT1NwPU.js","icon-MsvNhD56.js","MethodPill-CC7p0-fp.js","getPastedJson-BOWYR2ND.js","DuplicateIcon-DOWJyC1b.js","createIcon-BsNyCaLY.js","axios-CsQoIw0U.js","Markdown-L0uigQE0.js","AssistantPageLink-Cur5OU4v.js"]}