Wait for an ingestion job to reach a terminal status (completed, failed, or partial_success). Internally polls memories.status at the requested interval and returns the final status response. Useful for scripts and tests where you need a synchronous result before moving on.
Parameters
UUID
required
The ingestion job ID to wait on.
integer
Maximum time to wait in seconds. Defaults to 300.
integer
How often to poll for status in seconds. Defaults to 2.
Returns
MemoryStatusResponse: the final status response once the job reaches completed, failed, or partial_success. See memories.status for the full field list.
Prefer this helper over your own polling loop in scripts and integration tests. In production applications, poll memories.status at an interval that suits you, or skip the wait and let extraction finish in the background; you do not need wait_for_completion to use a memory later.
Raises
TimeoutError: when the job does not reach a terminal status within timeout_seconds.
AuthenticationError: when the API key is missing or invalid.
ContextNotFoundError: when the ingestion_id is unknown (HTTP 404).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Maximem Synap","description":"Agentic Context Management","colors":{"primary":"#F97316","light":"#FB923C","dark":"#EA580C"},"logo":{"light":"https://mintcdn.com/maximemai/SPYNqdr1ux3-6M5X/logo/light.svg?fit=max\u0026auto=format\u0026n=SPYNqdr1ux3-6M5X\u0026q=85\u0026s=3d97e9e6d78d58630c567324c4442134","dark":"https://mintcdn.com/maximemai/SPYNqdr1ux3-6M5X/logo/dark.svg?fit=max\u0026auto=format\u0026n=SPYNqdr1ux3-6M5X\u0026q=85\u0026s=05b696ab7b6b7941f2b2fca9ef22e96f","href":"https://docs.maximem.ai"},"favicon":{"light":"https://mintcdn.com/maximemai/9vY_tq7ZMQcuk3qQ/favicon.png?fit=max\u0026auto=format\u0026n=9vY_tq7ZMQcuk3qQ\u0026q=85\u0026s=c70baec828ea749010433a5cacc463a3","dark":"https://mintcdn.com/maximemai/9vY_tq7ZMQcuk3qQ/favicon.png?fit=max\u0026auto=format\u0026n=9vY_tq7ZMQcuk3qQ\u0026q=85\u0026s=c70baec828ea749010433a5cacc463a3"},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://github.com/maximem-ai","label":"GitHub"},{"href":"https://discord.gg/synap","label":"Community"},{"href":"mailto:[email protected]","label":"Support"},{"href":"/resources/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Dashboard","href":"https://synap.maximem.ai"}},"footer":{"socials":{"x":"https://twitter.com/maximem_ai","github":"https://github.com/maximem-ai","discord":"https://discord.gg/synap","linkedin":"https://www.linkedin.com/company/maximem-ai"}},"seo":{"metatags":{"robots":"index, follow","googlebot":"index, follow"},"indexing":"all"},"fonts":{"family":"Geist"},"styling":{"eyebrows":"section","latex":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":false},"markdown":{"instructions":["Maximem Synap is a managed memory layer for AI agents: it ingests conversations and documents, extracts structured memory, and returns scoped context to the agent at retrieval time.","The Python and JavaScript/TypeScript SDKs are the supported way to use Synap. Write integration code with SDK calls, not raw HTTP requests.","Start with the Quickstart: https://docs.maximem.ai/getting-started/quickstart.md. Every SDK method is documented in the SDK reference: https://docs.maximem.ai/sdk-reference/overview.md.","For requests about adding Vity memory to OpenClaw, Hermes, an MCP client, or a browser, start with the Vity Quickstart: https://docs.maximem.ai/vity/quickstart.md."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"maximemai","hasAudioNarration":false,"actualSubdomain":"maximemai","customDomains":["docs.maximem.ai"],"gitSource":{"type":"github","owner":"maximem-ai","repo":"maximem_synap_dev_docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{},"buildId":"6af47b35c0e883d57436cd47","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Synap","count":150},{"language":"default","tag":"Reference","count":49},{"language":"default","tag":"Integrations","count":26},{"language":"default","tag":"Guides","count":25},{"language":"default","tag":"Cookbook","count":21},{"language":"default","tag":"Agent frameworks","count":21},{"language":"default","tag":"Get Started","count":16},{"language":"default","tag":"Concepts","count":15},{"language":"default","tag":"Write memory","count":15},{"language":"default","tag":"Vity","count":15}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"sdk-reference/memories/wait-for-completion","slug":"/sdk-reference/memories/wait-for-completion","pageMetadata":{"title":"memories.wait_for_completion","description":"Block until an ingestion job reaches a terminal status, or raise on timeout.","tag":"READ","href":"/sdk-reference/memories/wait-for-completion"},"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: \"Block until an ingestion job reaches a terminal status, or raise on timeout.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,ParamField,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`1`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sdk.memories.wait_for_completion(ingestion_id, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`timeout_seconds`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`300`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`poll_interval_seconds`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`1`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`memories`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`wait_for_completion`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ingestionId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`string`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`options`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`?:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` WaitOptions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`Wait for an ingestion job to reach a terminal status (`,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`failed`}),`, or `,_jsx(_components.code,{children:`partial_success`}),`). Internally polls `,_jsx(_components.a,{href:`/sdk-reference/memories/status`,children:_jsx(_components.code,{children:`memories.status`})}),` at the requested interval and returns the final status response. Useful for scripts and tests where you need a synchronous result before moving on.`]}),`\n`,_jsx(Heading,{level:`3`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(ParamField,{path:`ingestion_id`,type:`UUID`,required:true,id:`param-ingestion-id`,children:_jsx(_components.p,{children:`The ingestion job ID to wait on.`})}),`\n`,_jsx(ParamField,{path:`timeout_seconds`,type:`integer`,id:`param-timeout-seconds`,children:_jsxs(_components.p,{children:[`Maximum time to wait in seconds. Defaults to `,_jsx(_components.code,{children:`300`}),`.`]})}),`\n`,_jsx(ParamField,{path:`poll_interval_seconds`,type:`integer`,id:`param-poll-interval-seconds`,children:_jsxs(_components.p,{children:[`How often to poll for status in seconds. Defaults to `,_jsx(_components.code,{children:`2`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`returns`,children:`Returns`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`MemoryStatusResponse`}),`: the final status response once the job reaches `,_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`failed`}),`, or `,_jsx(_components.code,{children:`partial_success`}),`. See `,_jsx(_components.a,{href:`/sdk-reference/memories/status`,children:_jsx(_components.code,{children:`memories.status`})}),` for the full field list.`]}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`20`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` maximem_synap `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` MaximemSynapSDK`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`sdk `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` MaximemSynapSDK(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"synap_your_key_here\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sdk.initialize()`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sdk.memories.create(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` document`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"User prefers email communication.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` document_type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ai-chat-conversation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` user_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` customer_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cust_456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` mode`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"long-range\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`final `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sdk.memories.wait_for_completion(`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` result.ingestion_id,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout_seconds`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`120`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` poll_interval_seconds`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(final.status) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# \"completed\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(final.memory_ids) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# IDs ready to fetch`})]}),`\n`]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Prefer this helper over your own polling loop in scripts and integration tests. In production applications, poll `,_jsx(_components.a,{href:`/sdk-reference/memories/status`,children:_jsx(_components.code,{children:`memories.status`})}),` at an interval that suits you, or skip the wait and let extraction finish in the background; you do not need `,_jsx(_components.code,{children:`wait_for_completion`}),` to use a memory later.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`raises`,children:`Raises`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`TimeoutError`}),`: when the job does not reach a terminal status within `,_jsx(_components.code,{children:`timeout_seconds`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`AuthenticationError`}),`: when the API key is missing or invalid.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ContextNotFoundError`}),`: when the `,_jsx(_components.code,{children:`ingestion_id`}),` is unknown (HTTP 404).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`see-also`,children:`See also`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/sdk-reference/memories/status`,children:`memories.status`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/sdk-reference/memories/create`,children:`memories.create`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/sdk-reference/memories/create-from-file`,children:`memories.create_from_file`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"memories.wait_for_completion","description":"Block until an ingestion job reaches a terminal status, or raise on timeout.","tag":"READ","href":"/sdk-reference/memories/wait-for-completion"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":3,"children":[]},{"title":"Returns","slug":"returns","depth":3,"children":[]},{"title":"Example","slug":"example","depth":3,"children":[]},{"title":"Raises","slug":"raises","depth":3,"children":[]},{"title":"See also","slug":"see-also","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/maximemai/4efe2e9bc914449b/webmcp.js"],"subdomain":"maximemai","siteName":"Maximem Synap","title":"memories.wait_for_completion - Maximem Synap","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T16:59:14.139Z","originalFileLocation":"sdk-reference/memories/wait-for-completion.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=\"Block until an ingestion job reaches a terminal status, or raise on timeout.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Maximem Synap\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_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=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"memories.wait_for_completion - Maximem Synap\">\u003cmeta data-mint-head property=\"og:description\" content=\"Block until an ingestion job reaches a terminal status, or raise on timeout.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Maximem Synap\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://maximemai.mintlify.site/_mintlify/api/og/v2?division=Write+memory\u0026amp;title=memories.wait_for_completion\u0026amp;description=Block+until+an+ingestion+job+reaches+a+terminal+status%2C+or+raise+on+timeout.\u0026amp;theme=8d273a848d7d43e51587faec\u0026amp;signature=c57c8e3ab05effd61a2c15b42f051ba4c7cb15966e46f153259bfa1991ef9b75\">\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=\"memories.wait_for_completion - Maximem Synap\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Block until an ingestion job reaches a terminal status, or raise on timeout.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://maximemai.mintlify.site/_mintlify/api/og/v2?division=Write+memory\u0026amp;title=memories.wait_for_completion\u0026amp;description=Block+until+an+ingestion+job+reaches+a+terminal+status%2C+or+raise+on+timeout.\u0026amp;theme=8d273a848d7d43e51587faec\u0026amp;signature=c57c8e3ab05effd61a2c15b42f051ba4c7cb15966e46f153259bfa1991ef9b75\">\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=\"/mintlify-assets/_mintlify/favicons/maximemai/MD073HG6TL_XNNyt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Maximem Synap\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F97316\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk-reference/memories/wait-for-completion.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.maximem.ai/#organization\",\"name\":\"Maximem Synap\",\"url\":\"https://docs.maximem.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/maximemai/SPYNqdr1ux3-6M5X/logo/light.svg?fit=max\u0026auto=format\u0026n=SPYNqdr1ux3-6M5X\u0026q=85\u0026s=3d97e9e6d78d58630c567324c4442134\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.maximem.ai#website\",\"name\":\"Maximem Synap\",\"url\":\"https://docs.maximem.ai\",\"publisher\":{\"@id\":\"https://docs.maximem.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion#webpage\",\"url\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion\",\"name\":\"memories.wait_for_completion\",\"description\":\"Block until an ingestion job reaches a terminal status, or raise on timeout.\",\"dateModified\":\"2026-10-22T16:59:14.139Z\",\"isPartOf\":{\"@id\":\"https://docs.maximem.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Write memory\",\"item\":\"https://docs.maximem.ai/sdk-reference/memories/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"memories.wait_for_completion\",\"item\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion#article\",\"headline\":\"memories.wait_for_completion\",\"name\":\"memories.wait_for_completion\",\"description\":\"Block until an ingestion job reaches a terminal status, or raise on timeout.\",\"url\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion\",\"mainEntityOfPage\":{\"@id\":\"https://docs.maximem.ai/sdk-reference/memories/wait-for-completion#webpage\"},\"dateModified\":\"2026-10-22T16:59:14.139Z\",\"publisher\":{\"@id\":\"https://docs.maximem.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.maximem.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Maximem Synap\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Maximem Synap\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sdk-reference/memories/wait-for-completion.md","siteName":"Maximem Synap","nav":{"global":null,"products":[{"product":"Synap","icon":"layer-group","description":"Memory layer and SDK for your agent","tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/setup/installation"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/memory-model-cheat-sheet"}]},{"tab":"Cookbook","pages":[{"title":"Cookbook","href":"/patterns/overview"}]},{"tab":"Reference","groups":[{"group":"SDK reference","pages":[{"title":"SDK reference","sidebarTitle":"Overview","icon":"globe","href":"/sdk-reference/overview"},{"title":"Types and enums","sidebarTitle":"Types and enums","href":"/sdk-reference/types-and-enums"}]},{"group":"Lifecycle","pages":[{"title":"initialize","tag":"LOCAL","href":"/sdk-reference/lifecycle/initialize"},{"title":"configure","tag":"LOCAL","href":"/sdk-reference/lifecycle/configure"},{"title":"shutdown","tag":"LOCAL","href":"/sdk-reference/lifecycle/shutdown"},{"title":"as_tool","tag":"LOCAL","href":"/sdk-reference/lifecycle/as-tool"}]},{"group":"Write memory","pages":[{"title":"memories.create","tag":"CREATE","href":"/sdk-reference/memories/create"},{"title":"memories.batch_create","tag":"CREATE","href":"/sdk-reference/memories/batch-create"},{"title":"memories.create_from_file","tag":"CREATE","href":"/sdk-reference/memories/create-from-file"},{"title":"memories.status","description":"Check the progress of an asynchronous ingestion job.","tag":"READ","href":"/sdk-reference/memories/status"},{"title":"memories.wait_for_completion","tag":"READ","href":"/sdk-reference/memories/wait-for-completion"},{"title":"conversation.record_message","description":"Record a single conversation message (user or assistant turn) into Synap.","tag":"CREATE","href":"/sdk-reference/conversation/record-message"},{"title":"conversation.record_messages_batch","tag":"CREATE","href":"/sdk-reference/conversation/record-messages-batch"},{"title":"conversation.ingest_transcript","tag":"CREATE","href":"/sdk-reference/conversation/ingest-transcript"},{"title":"instance.listen","tag":"Cloud only","href":"/sdk-reference/instance/listen"},{"title":"instance.send_message","tag":"Cloud only","href":"/sdk-reference/instance/send-message"},{"title":"instance.record_thinking","tag":"Cloud only","href":"/sdk-reference/instance/record-thinking"},{"title":"instance.record_tool_call","tag":"Cloud only","href":"/sdk-reference/instance/record-tool-call"},{"title":"instance.record_tool_result","tag":"Cloud only","href":"/sdk-reference/instance/record-tool-result"},{"title":"instance.end_session","tag":"Cloud only","href":"/sdk-reference/instance/end-session"},{"title":"instance.stop_listening","tag":"Cloud only","href":"/sdk-reference/instance/stop-listening"}]},{"group":"Read context","pages":[{"title":"conversation.context.fetch","tag":"READ","href":"/sdk-reference/conversation-context/fetch"},{"title":"conversation.context.compact","tag":"UPDATE","href":"/sdk-reference/conversation-context/compact"},{"title":"conversation.context.get_compacted","tag":"READ","href":"/sdk-reference/conversation-context/get-compacted"},{"title":"conversation.context.get_compaction_status","tag":"READ","href":"/sdk-reference/conversation-context/get-compaction-status"},{"title":"conversation.context.get_context_for_prompt","tag":"READ","href":"/sdk-reference/conversation-context/get-context-for-prompt"},{"title":"fetch","tag":"READ","href":"/sdk-reference/context/fetch"},{"title":"user.context.fetch","tag":"READ","href":"/sdk-reference/context/user-fetch"},{"title":"customer.context.fetch","tag":"READ","href":"/sdk-reference/context/customer-fetch"},{"title":"client.context.fetch","tag":"READ","href":"/sdk-reference/context/client-fetch"},{"title":"user.get_profile","tag":"READ","href":"/sdk-reference/user/get-profile"}]},{"group":"Manage","pages":[{"title":"memories.get","tag":"READ","href":"/sdk-reference/memories/get"},{"title":"memories.update","tag":"UPDATE","href":"/sdk-reference/memories/update"},{"title":"memories.delete","tag":"DELETE","href":"/sdk-reference/memories/delete"},{"title":"memories.forget","tag":"DELETE","href":"/sdk-reference/memories/forget"},{"title":"cache.clear","tag":"DELETE","href":"/sdk-reference/cache/clear"},{"title":"cache.clear_user","tag":"DELETE","href":"/sdk-reference/cache/clear-user"},{"title":"cache.clear_customer","tag":"DELETE","href":"/sdk-reference/cache/clear-customer"},{"title":"cache.stats","tag":"READ","href":"/sdk-reference/cache/stats"},{"title":"credits.get_balance","tag":"Cloud only","href":"/sdk-reference/credits/get-balance"},{"title":"credits.get_ledger","tag":"Cloud only","href":"/sdk-reference/credits/get-ledger"},{"title":"credits.estimate","tag":"Cloud only","href":"/sdk-reference/credits/estimate"},{"title":"credits.redeem","tag":"Cloud only","href":"/sdk-reference/credits/redeem"}]},{"group":"CLI and errors","pages":[{"title":"CLI command reference","icon":"rectangle-terminal","href":"/cli/commands"},{"title":"Error Codes","sidebarTitle":"Error codes","icon":"exclamation-circle","href":"/sdk-reference/errors"}]},{"group":"Resources","pages":[{"title":"Glossary","icon":"book-open","href":"/resources/glossary"},{"title":"FAQ","icon":"question-circle","href":"/resources/faq"},{"title":"Security \u0026 Trust","sidebarTitle":"Security and trust","icon":"shield-check","href":"/resources/security-trust"},{"title":"Support","icon":"life-ring","href":"/resources/support"}]}]}]},{"product":"Vity","icon":"brain","description":"Memory for your agent: OpenClaw, Hermes, MCP, browser","pages":[{"title":"Vity","href":"/vity/overview"}]}]},"basePath":"","title":"memories.wait_for_completion - Maximem Synap","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}