{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Alchemyst AI Documentation","colors":{"primary":"#f59025","light":"#f39025","dark":"#252525"},"logo":{"light":"https://mintcdn.com/alchemystai/n0wOjoklmEpTH562/logo/logo-full-light.jpeg?fit=max\u0026auto=format\u0026n=n0wOjoklmEpTH562\u0026q=85\u0026s=cafd369adf8b0161f2558e3d7d5bc3b6","dark":"https://mintcdn.com/alchemystai/YafgpqUWGlMUt5k5/logo/logo-full.webp?fit=max\u0026auto=format\u0026n=YafgpqUWGlMUt5k5\u0026q=85\u0026s=5c28457fe8f4f9423bd4c8bd0d0a7252","href":"https://getalchemystai.com"},"favicon":"https://mintcdn.com/alchemystai/ZQkyJfbxY8JTOsLY/logo/logo.png?fit=max\u0026auto=format\u0026n=ZQkyJfbxY8JTOsLY\u0026q=85\u0026s=3e6229f9da592f86b4442962addefb13","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[{"href":"mailto:anuran@getalchemystai.com","label":"Support"},{"href":"/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.getalchemystai.com/auth?utm_source=docs\u0026utm_campaign=docs_dashboard_button\u0026utm_medium=button\u0026utm_content=dashboard_button"}},"footer":{"socials":{"x":"https://x.com/getalchemyst","github":"https://github.com/alchemyst-ai","linkedin":"https://linkedin.com/company/alchemystai","discord":"https://getalchemystai.com/docs/join-discord?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=discord_join"}},"search":{"prompt":"Search Alchemyst AI documentation..."},"seo":{"metatags":{"og:type":"website","og:site_name":"Alchemyst AI Documentation","og:title":"Alchemyst AI - AI-Native Context Management Platform","og:description":"Alchemyst AI is the Pareto Frontier for AI Context. Build scalable, context-aware AI agents with native support for LangChain, LlamaIndex, Vercel AI SDK, Agno, and Model Context Protocol. Sub-100ms latency, comprehensive SDKs, and enterprise-ready.","og:image":"https://getalchemystai.com/images/og-image.png","og:image:width":"1200","og:image:height":"630","og:url":"https://docs.getalchemystai.com","twitter:card":"summary_large_image","twitter:site":"@getalchemyst","twitter:creator":"@getalchemyst","twitter:title":"Alchemyst AI - Context Management for AI Applications","twitter:description":"Pareto Frontier for AI Context. Native integrations with LangChain, LlamaIndex, MCP servers, Chrome extension, and more. Build context-aware AI agents with sub-100ms performance.","twitter:image":"https://getalchemystai.com/images/og-image.png","description":"Alchemyst AI is the leading AI-native context management platform. Learn how to implement persistent memory, context retrieval, and RAG optimization for AI agents. Includes Python SDK, TypeScript SDK, LangChain integration, LlamaIndex support, MCP servers for Cursor and Claude Desktop, Chrome extension, and comprehensive API documentation.","keywords":"Alchemyst AI, AI context management, LLM context, conversational memory, context layer, AI agents, LangChain memory, LlamaIndex integration, Vercel AI SDK, Agno integration, Model Context Protocol, MCP server, RAG optimization, retrieval augmented generation, vector database, AI SDK, context retrieval, persistent memory, chatbot memory, AI application development, semantic search, embedding storage, context injection, AI middleware, LLM memory systems","author":"Alchemyst AI","robots":"index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1","googlebot":"index, follow","bingbot":"index, follow","language":"en","revisit-after":"7 days","article:author":"Alchemyst AI Team","article:publisher":"https://getalchemystai.com","canonical":"https://docs.getalchemystai.com"},"indexing":"all"},"fonts":{"heading":{"family":"Sora","weight":400,"format":"woff2"},"body":{"family":"Sora","weight":400,"format":"woff2"}},"integrations":{"ga4":{"measurementId":"G-WHNWY5LTDN"}},"banner":{"content":"🚀 Alchemyst is now the Pareto Frontier for AI Context! [Learn more](https://getalchemystai.com/benchmarks?utm_source=docs\u0026utm_campaign=pareto_frontier_announcement\u0026utm_medium=announcement\u0026utm_content=alchemyst_is_now_pareto_frontier)","dismissible":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"book-open-cover","href":"https://getalchemystai.com?utm_source=docs\u0026utm_campaign=docs\u0026utm_medium=web"},{"anchor":"llms.txt","icon":"file-text","href":"https://getalchemystai.com/docs/llms.txt"},{"anchor":"llms-full.txt","icon":"book","href":"https://getalchemystai.com/docs/llms-full.txt"},{"anchor":"Community","icon":"discord","href":"https://getalchemystai.com/docs/join-discord?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=discord_join"},{"anchor":"Blog","icon":"newspaper","href":"https://getalchemystai.com/blog?utm_source=docs\u0026utm_campaign=docs\u0026utm_medium=web"},{"anchor":"API Status","icon":"signal-bars","href":"https://status.getalchemystai.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"alchemystai","hasAudioNarration":false,"actualSubdomain":"alchemystai","customDomains":["getalchemystai.com"],"gitSource":{"type":"github","owner":"alchemyst-ai","repo":"docs","deployBranch":"main","contentDirectory":"developer-docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab7909ef8b8b60f364fbf56","collectionId":"4efa7aee-620b-4aae-ba1f-73d49023a493","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab7909ef8b8b60f364fbf56"},"entitlements":{},"buildId":"6ab7909ef8b8b60f364fbf56","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Integrations","count":25},{"language":"default","tag":"API reference","count":17},{"language":"default","tag":"Endpoint examples","count":16},{"language":"default","tag":"Guides","count":13},{"language":"default","tag":"Third-party integrations","count":12},{"language":"default","tag":"Cookbook","count":9},{"language":"default","tag":"MCPs","count":8},{"language":"default","tag":"Data Sources","count":6},{"language":"default","tag":"Advanced Usage","count":5},{"language":"default","tag":"By our community","count":4}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/endpoint/api/v1/context/memory/add/post","slug":"/api-reference/endpoint/api/v1/context/memory/add/post","pageMetadata":{"title":"Add memory context data","openapi":"POST /api/v1/context/memory/add","description":"This endpoint adds memory (chat history) as context.","href":"/api-reference/endpoint/api/v1/context/memory/add/post"},"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: \"This endpoint adds memory (chat history) as context.\"\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":{"config":{},"pageMetadata":{"title":"Add memory context data","openapi":"POST /api/v1/context/memory/add","description":"This endpoint adds memory (chat history) as context.","href":"/api-reference/endpoint/api/v1/context/memory/add/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/alchemystai/2f00c254094e5415/action.js","/docs/_mintlify/custom/alchemystai/31ab0e2c2d9859da/ctx.js"],"openApiReferenceData":{"operation":{"operationId":"addContextAsMemory","summary":"Add memory context data","description":"This endpoint adds memory (chat history) as context.","tags":["context"],"security":["bf89e4ae-db2b-4505-9409-517423fb2d5f"],"requestBody":"d25ea274-9547-4dac-a875-05fc76c3aae3","responses":{"201":"ecb4a84b-4c7f-47be-8e2b-85dbb371fbd0","400":"5d9668b7-a0ab-4f5e-a964-fd4b63411577","401":"d1636b52-0975-43ed-a357-f81688893b17","402":"4ddc0aff-57ae-4460-9547-00e5146d1f67","403":"e1c2d75d-2cbb-4852-bee1-f2eea45ee316","404":"bb395966-e13f-4015-bbd2-ccb9f08f45d8","500":"91c79e15-690b-4add-8a42-7f25c9de688d"},"method":"post","type":"path","servers":["bcc2d902-ee69-4e24-8763-1c980629119e"],"path":"/api/v1/context/memory/add","baseUrlOptions":["https://platform-backend.getalchemystai.com"],"title":"Add memory context data","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sessionId","contents"],"properties":{"sessionId":{"type":"string","description":"The ID of the session","isRequired":true,"uniqueKey":"sessionId","typeLabel":"string"},"contents":{"type":"array","description":"Array of content objects. Each object must contain at least the 'content' field. Additional properties are allowed.","items":{"type":"object","required":["content"],"properties":{"content":{"type":"string","description":"The content of the memory message","isRequired":true,"uniqueKey":"contents.items.[INDEX].content","typeLabel":"string"},"metadata":{"type":"object","description":"Additional metadata for the message (optional)","properties":{"messageId":{"type":"string","description":"Unique message ID","uniqueKey":"contents.items.[INDEX].metadata.messageId","typeLabel":"string"}},"uniqueKey":"contents.items.[INDEX].metadata","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"contents.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"contents","typeLabel":"object[]"},"metadata":{"type":"object","description":"Optional metadata for the memory context. Defaults to [\"default\"] if not provided.","properties":{"groupName":{"type":"array","items":{"type":"string","uniqueKey":"metadata.groupName.items.[INDEX]","typeLabel":"string"},"description":"Optional group names for the memory context. Defaults to [\"default\"] if not provided.","default":["default"],"uniqueKey":"metadata.groupName","typeLabel":"string[]"}},"additionalProperties":true,"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"minimal":{"title":"minimal","value":{"sessionId":"support-thread-TCK-1234","contents":[{"content":"Customer asked about pricing for the Scale plan."}]}},"withMessageMetadata":{"title":"withMessageMetadata","value":{"sessionId":"support-thread-TCK-1234","contents":[{"content":"Customer asked about pricing for the Scale plan.","metadata":{"messageId":"msg_001"}},{"content":"Agent responded with pricing details for Scale plan.","metadata":{"messageId":"msg_002"}}]}},"withGroupMetadata":{"title":"withGroupMetadata","value":{"sessionId":"support-thread-TCK-1234","contents":[{"content":"Customer asked about pricing for the Scale plan."}],"metadata":{"groupName":["support","pricing"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ecb4a84b-4c7f-47be-8e2b-85dbb371fbd0":{"description":"Memory context added successfully","content":{"application/json":{"schema":{"type":"object","required":["success","context_id"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"context_id":{"type":"string","example":"ctx_01HXYZABC","isRequired":true,"uniqueKey":"context_id","typeLabel":"string"},"processed_documents":{"type":"number","example":2,"uniqueKey":"processed_documents","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"context_id":"ctx_01HXYZABC","processed_documents":1},"examples":{"Example":{"title":"Example","value":{"success":true,"context_id":"ctx_01HXYZABC","processed_documents":1}}},"exampleType":"examples"}},"exampleType":"examples"},"5d9668b7-a0ab-4f5e-a964-fd4b63411577":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","example":"Error details","required":["code","message"],"properties":{"code":{"type":"string","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"User not authenticated","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"message":{"type":"string","example":"Invalid job id","uniqueKey":"message","typeLabel":"string"},"status":{"type":"number","example":400,"uniqueKey":"status","typeLabel":"number"},"statusText":{"type":"string","description":"Error message (detailed in debug mode)","uniqueKey":"statusText","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"INVALID_REQUEST","message":"sessionId field is required"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"INVALID_REQUEST","message":"sessionId field is required"}}}},"exampleType":"examples"}},"exampleType":"examples"},"d1636b52-0975-43ed-a357-f81688893b17":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","example":"Error details","required":["code","message"],"properties":{"code":{"type":"string","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"User not authenticated","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"message":{"type":"string","example":"Invalid job id","uniqueKey":"message","typeLabel":"string"},"status":{"type":"number","example":400,"uniqueKey":"status","typeLabel":"number"},"statusText":{"type":"string","description":"Error message (detailed in debug mode)","uniqueKey":"statusText","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Error details","message":"Invalid job id","status":400,"statusText":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4ddc0aff-57ae-4460-9547-00e5146d1f67":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","example":"Error details","required":["code","message"],"properties":{"code":{"type":"string","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"User not authenticated","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"message":{"type":"string","example":"Invalid job id","uniqueKey":"message","typeLabel":"string"},"status":{"type":"number","example":400,"uniqueKey":"status","typeLabel":"number"},"statusText":{"type":"string","description":"Error message (detailed in debug mode)","uniqueKey":"statusText","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Error details","message":"Invalid job id","status":400,"statusText":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e1c2d75d-2cbb-4852-bee1-f2eea45ee316":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","example":"Error details","required":["code","message"],"properties":{"code":{"type":"string","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"User not authenticated","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"message":{"type":"string","example":"Invalid job id","uniqueKey":"message","typeLabel":"string"},"status":{"type":"number","example":400,"uniqueKey":"status","typeLabel":"number"},"statusText":{"type":"string","description":"Error message (detailed in debug mode)","uniqueKey":"statusText","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Error details","message":"Invalid job id","status":400,"statusText":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"bb395966-e13f-4015-bbd2-ccb9f08f45d8":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","example":"Error details","required":["code","message"],"properties":{"code":{"type":"string","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"User not authenticated","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"message":{"type":"string","example":"Invalid job id","uniqueKey":"message","typeLabel":"string"},"status":{"type":"number","example":400,"uniqueKey":"status","typeLabel":"number"},"statusText":{"type":"string","description":"Error message (detailed in debug mode)","uniqueKey":"statusText","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Error details","message":"Invalid job id","status":400,"statusText":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"91c79e15-690b-4add-8a42-7f25c9de688d":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","example":"Error details","required":["code","message"],"properties":{"code":{"type":"string","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"User not authenticated","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"message":{"type":"string","example":"Invalid job id","uniqueKey":"message","typeLabel":"string"},"status":{"type":"number","example":400,"uniqueKey":"status","typeLabel":"number"},"statusText":{"type":"string","description":"Error message (detailed in debug mode)","uniqueKey":"statusText","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Error details","message":"Invalid job id","status":400,"statusText":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bf89e4ae-db2b-4505-9409-517423fb2d5f":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"bcc2d902-ee69-4e24-8763-1c980629119e":{"url":"https://platform-backend.getalchemystai.com","description":"production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"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":"api-reference/openapi.json"},"subdomain":"alchemystai","siteName":"Alchemyst AI Documentation","title":"Alchemyst AI - AI-Native Context Management Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-28T19:06:44.129Z","originalFileLocation":"api-reference/endpoint/api/v1/context/memory/add/post.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=\"This endpoint adds memory (chat history) as context.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Alchemyst AI, AI context management, LLM context, conversational memory, context layer, AI agents, LangChain memory, LlamaIndex integration, Vercel AI SDK, Agno integration, Model Context Protocol, MCP server, RAG optimization, retrieval augmented generation, vector database, AI SDK, context retrieval, persistent memory, chatbot memory, AI application development, semantic search, embedding storage, context injection, AI middleware, LLM memory systems\">\u003cmeta data-mint-head name=\"application-name\" content=\"Alchemyst AI Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_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/alchemystai/LTKvFpxAHS9N-ZGy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Alchemyst AI - AI-Native Context Management Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Alchemyst AI is the Pareto Frontier for AI Context. Build scalable, context-aware AI agents with native support for LangChain, LlamaIndex, Vercel AI SDK, Agno, and Model Context Protocol. Sub-100ms latency, comprehensive SDKs, and enterprise-ready.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Alchemyst AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://getalchemystai.com/images/og-image.png\">\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=\"Alchemyst AI - Context Management for AI Applications\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Pareto Frontier for AI Context. Native integrations with LangChain, LlamaIndex, MCP servers, Chrome extension, and more. Build context-aware AI agents with sub-100ms performance.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://getalchemystai.com/images/og-image.png\">\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/alchemystai/LTKvFpxAHS9N-ZGy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Alchemyst AI Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#f59025\">\u003cmeta data-mint-head name=\"article:publisher\" content=\"https://getalchemystai.com\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@getalchemyst\">\u003cmeta data-mint-head name=\"author\" content=\"Alchemyst AI\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"bingbot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"revisit-after\" content=\"7 days\">\u003cmeta data-mint-head name=\"article:author\" content=\"Alchemyst AI Team\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post\">\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/endpoint/api/v1/context/memory/add/post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getalchemystai.com/#organization\",\"name\":\"Alchemyst AI Documentation\",\"url\":\"https://docs.getalchemystai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/alchemystai/n0wOjoklmEpTH562/logo/logo-full-light.jpeg?fit=max\u0026auto=format\u0026n=n0wOjoklmEpTH562\u0026q=85\u0026s=cafd369adf8b0161f2558e3d7d5bc3b6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getalchemystai.com#website\",\"name\":\"Alchemyst AI Documentation\",\"url\":\"https://docs.getalchemystai.com\",\"publisher\":{\"@id\":\"https://docs.getalchemystai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post#webpage\",\"url\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post\",\"name\":\"Add memory context data\",\"description\":\"This endpoint adds memory (chat history) as context.\",\"dateModified\":\"2026-01-28T19:06:44.129Z\",\"isPartOf\":{\"@id\":\"https://docs.getalchemystai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoint examples\",\"item\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add memory context data\",\"item\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post#apireference\",\"headline\":\"Add memory context data\",\"name\":\"Add memory context data\",\"description\":\"This endpoint adds memory (chat history) as context.\",\"url\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/memory/add/post#webpage\"},\"image\":\"https://getalchemystai.com/images/og-image.png\",\"dateModified\":\"2026-01-28T19:06:44.129Z\",\"publisher\":{\"@id\":\"https://docs.getalchemystai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getalchemystai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Alchemyst AI Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Alchemyst AI Documentation","nav":{"global":{"anchors":[{"anchor":"Website","icon":"book-open-cover","href":"https://getalchemystai.com?utm_source=docs\u0026utm_campaign=docs\u0026utm_medium=web"},{"anchor":"llms.txt","icon":"file-text","href":"https://getalchemystai.com/docs/llms.txt"},{"anchor":"llms-full.txt","icon":"book","href":"https://getalchemystai.com/docs/llms-full.txt"},{"anchor":"Community","icon":"discord","href":"https://getalchemystai.com/docs/join-discord?utm_source=docs\u0026utm_medium=referral\u0026utm_campaign=discord_join"},{"anchor":"Blog","icon":"newspaper","href":"https://getalchemystai.com/blog?utm_source=docs\u0026utm_campaign=docs\u0026utm_medium=web"},{"anchor":"API Status","icon":"signal-bars","href":"https://status.getalchemystai.com"}]},"tabs":[{"tab":"Welcome","icon":"stars","pages":[{"title":"Welcome","href":""}]},{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/getting-started"}]},{"tab":"Cookbook","icon":"utensils","pages":[{"title":"Cookbook","href":"/example-projects/team/cli-chatbot"}]},{"tab":"Integrations","icon":"puzzle-piece","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"MCPs","icon":"plug","pages":[{"title":"MCPs","href":"/mcps/introduction"}]},{"tab":"API reference","icon":"code","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoint examples","pages":[{"title":"Add context data to the context processor","openapi":"POST /api/v1/context/add","href":"/api-reference/endpoint/api/v1/context/add/post"},{"title":"Asynchronously queue context data to add to the context processor","openapi":"POST /api/v1/context/add-async","href":"/api-reference/endpoint/api/v1/context/add-async/post"},{"title":"List all ongoing context add jobs for the authenticated user","openapi":"GET /api/v1/context/add-async/status","href":"/api-reference/endpoint/api/v1/context/add-async/status/get"},{"title":"Cancel a context add job","openapi":"DELETE /api/v1/context/add-async/{id}/cancel","href":"/api-reference/endpoint/api/v1/context/add-async/{id}/cancel/delete"},{"title":"Get status of a context add job","openapi":"GET /api/v1/context/add-async/{id}/status","href":"/api-reference/endpoint/api/v1/context/add-async/{id}/status/get"},{"title":"Delete context data from the context processor","openapi":"POST /api/v1/context/delete","description":"This endpoint deletes context data based on the provided parameters. It returns a success or error response depending on the result from the context processor.","href":"/api-reference/endpoint/api/v1/context/delete/post"},{"title":"Add memory context data","openapi":"POST /api/v1/context/memory/add","href":"/api-reference/endpoint/api/v1/context/memory/add/post"},{"title":"Delete memory context data","openapi":"POST /api/v1/context/memory/delete","description":"Deletes memory context data based on provided parameters.","href":"/api-reference/endpoint/api/v1/context/memory/delete/post"},{"title":"Update memory context data","openapi":"POST /api/v1/context/memory/update","href":"/api-reference/endpoint/api/v1/context/memory/update/post"},{"title":"Search for context data in the context processor","openapi":"POST /api/v1/context/search","href":"/api-reference/endpoint/api/v1/context/search/post"},{"title":"Search and summarize context based on steering prompt","openapi":"POST /api/v1/context/search/steer","href":"/api-reference/endpoint/api/v1/context/search/steer/post"},{"title":"Retrieves a list of traces for the authenticated user","openapi":"GET /api/v1/context/traces","href":"/api-reference/endpoint/api/v1/context/traces/get"},{"title":"Delete a specific data trace","openapi":"DELETE /api/v1/context/traces/{traceId}/delete","href":"/api-reference/endpoint/api/v1/context/traces/{traceId}/delete/delete"},{"title":"Retrieve user contexts by documents","openapi":"GET /api/v1/context/view/docs","href":"/api-reference/endpoint/api/v1/context/view/docs/get"},{"title":"Retrieve user context","openapi":"GET /api/v1/context/view","href":"/api-reference/endpoint/api/v1/context/view/get"},{"title":"View organization context","openapi":"POST /api/v1/org/context/view","href":"/api-reference/endpoint/api/v1/org/context/view/post"}]}]},{"tab":"Changelog","icon":"list","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Alchemyst AI - AI-Native Context Management Platform","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-EI3b4dIs.js","dist-C3vb5JQZ.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-C6CAjViH.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-Bg4Z7D_G.js","utils-Biz734EK.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6F9YHs6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BoJjY_VP.js","snippetPresets-CnZ-mOFh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DC_SB2pp.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BYKtOiIP.js","shallow-COAac_UD.js","getApiPlaygroundDisplay-BV4Viqi2.js","CodeSnippet-DDgW-JXl.js","CodeSnippets-CP1LpNhG.js","Page-BeiUfucV.js","getPastedJson-Cvgvbfmv.js","icon-D-H368xH.js","MethodPill-CXSxH1VW.js","DuplicateIcon-JcbBzF1x.js","createIcon-BDt_aHZM.js","DynamicMarkdown-DO1Fz7ar.js","SectionHeading-mwKBArs3.js","axios-vUo_bRtp.js","Markdown-C3KUTGJN.js","AssistantPageLink-C8Hisf3g.js"]}