This endpoint accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.
{"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/add/post","slug":"/api-reference/endpoint/api/v1/context/add/post","pageMetadata":{"title":"Add context data to the context processor","openapi":"POST /api/v1/context/add","description":"This endpoint accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.","href":"/api-reference/endpoint/api/v1/context/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 accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.\"\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 context data to the context processor","openapi":"POST /api/v1/context/add","description":"This endpoint accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.","href":"/api-reference/endpoint/api/v1/context/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":"addContextSync","summary":"Add context data to the context processor","description":"This endpoint accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.","tags":["context"],"security":["968fe413-2c5f-4cae-8ff1-5886165a2ace"],"requestBody":"84feb61f-d654-4950-8c1d-d1585ad3b2ab","responses":{"201":"fd26cf4d-42fa-4607-a687-b95e38dc052b","400":"2a5a907b-1268-4269-b84d-658538a07992","401":"91f1d28a-9aa6-42b1-95b8-683e59e1574c","402":"13efe5db-fbb4-490f-8002-6f4279ef9bd3","403":"3521e43f-39f1-464c-b0aa-599578df2bed","404":"f2c764e1-5da0-4d2b-be54-29b4ebc1f028","500":"bdc228a9-7fa7-4eea-8a1f-b5ecb96d722f"},"method":"post","type":"path","servers":["bcc2d902-ee69-4e24-8763-1c980629119e"],"path":"/api/v1/context/add","baseUrlOptions":["https://platform-backend.getalchemystai.com"],"title":"Add context data to the context processor","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["documents","context_type","source","scope"],"properties":{"documents":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"The content of the document","uniqueKey":"documents.items.[INDEX].content","typeLabel":"string"}},"additionalProperties":{"type":"string","uniqueKey":"documents.items.[INDEX].additionalProperties","typeLabel":"string"},"uniqueKey":"documents.items.[INDEX]","typeLabel":"object"},"description":"Array of documents with content and additional metadata","isRequired":true,"uniqueKey":"documents","typeLabel":"object[]"},"source":{"type":"string","description":"The source of the context data","isRequired":true,"uniqueKey":"source","typeLabel":"string"},"context_type":{"type":"string","enum":["resource","conversation","instruction"],"description":"Type of context being added","isRequired":true,"uniqueKey":"context_type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["internal","external"],"default":"internal","description":"Scope of the context","isRequired":true,"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","description":"Additional metadata for the context","properties":{"fileName":{"type":"string","description":"Name of the file","uniqueKey":"metadata.fileName","typeLabel":"string"},"fileType":{"type":"string","description":"Type/MIME of the file","uniqueKey":"metadata.fileType","typeLabel":"string"},"groupName":{"type":"array","items":{"type":"string","uniqueKey":"metadata.groupName.items.[INDEX]","typeLabel":"string"},"description":"Array of Group Name to which the file belongs to","uniqueKey":"metadata.groupName","typeLabel":"string[]"},"lastModified":{"type":"string","description":"Last modified timestamp","uniqueKey":"metadata.lastModified","typeLabel":"string"},"fileSize":{"type":"number","description":"Size of the file in bytes","uniqueKey":"metadata.fileSize","typeLabel":"number"}},"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"documents":[{"content":"Customer asked about pricing for the Scale plan."}],"source":"support-inbox","context_type":"resource","scope":"internal","metadata":{"fileName":"support_thread_TCK-1234.txt","fileType":"text/plain","groupName":["support","pricing"],"lastModified":"2025-01-10T12:34:56.000Z","fileSize":2048}},"examples":{"Example":{"title":"Example","value":{"documents":[{"content":"Customer asked about pricing for the Scale plan."}],"source":"support-inbox","context_type":"resource","scope":"internal","metadata":{"fileName":"support_thread_TCK-1234.txt","fileType":"text/plain","groupName":["support","pricing"],"lastModified":"2025-01-10T12:34:56.000Z","fileSize":2048}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"fd26cf4d-42fa-4607-a687-b95e38dc052b":{"description":"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"},"examples":{"Example":{"title":"Example","value":{"success":true,"context_id":"ctx_01HXYZABC","processed_documents":2}}},"exampleType":"generated"}},"exampleType":"generated"},"2a5a907b-1268-4269-b84d-658538a07992":{"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"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Error details","message":"Invalid job id","status":400,"statusText":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"91f1d28a-9aa6-42b1-95b8-683e59e1574c":{"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"},"13efe5db-fbb4-490f-8002-6f4279ef9bd3":{"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"},"3521e43f-39f1-464c-b0aa-599578df2bed":{"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"},"f2c764e1-5da0-4d2b-be54-29b4ebc1f028":{"description":"Not Found - Invalid context data format","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"},"bdc228a9-7fa7-4eea-8a1f-b5ecb96d722f":{"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":{"968fe413-2c5f-4cae-8ff1-5886165a2ace":{"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.128Z","originalFileLocation":"api-reference/endpoint/api/v1/context/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 accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.\">\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/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/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/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/add/post#webpage\",\"url\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post\",\"name\":\"Add context data to the context processor\",\"description\":\"This endpoint accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.\",\"dateModified\":\"2026-01-28T19:06:44.128Z\",\"isPartOf\":{\"@id\":\"https://docs.getalchemystai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Alchemyst AI Documentation\",\"item\":\"https://docs.getalchemystai.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add context data to the context processor\",\"item\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post#apireference\",\"headline\":\"Add context data to the context processor\",\"name\":\"Add context data to the context processor\",\"description\":\"This endpoint accepts context data and sends it to a context processor for further handling. It returns a success or error response depending on the result from the context processor.\",\"url\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getalchemystai.com/api-reference/endpoint/api/v1/context/add/post#webpage\"},\"image\":\"https://getalchemystai.com/images/og-image.png\",\"dateModified\":\"2026-01-28T19:06:44.128Z\",\"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","description":"API documentation and reference","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","description":"This endpoint accepts context data and queues it for asynchronous processing by the context processor. It returns a success or error response depending on the queuing result.","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","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","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"]}