Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Parallel","description":"Parallel's web APIs (Search, Extract, Task/Deep Research, Responses, FindAll, and Monitor) give AI agents and developers high-quality, low-latency access to the web for research, content extraction, entity discovery, and continuous monitoring. For Search and Extract, use /v1/search and /v1/extract for all new integrations and agent tool calls; use /v1beta/search and /v1beta/extract only when maintaining an existing integration that already uses them. The request bodies changed too: on /v1/extract, full_content, fetch_policy and excerpt_settings go inside advanced_settings, and sending the v1beta top-level excerpts, full_content and fetch_policy to /v1/extract returns a 422. On /v1/search, search_queries is required (at least one short keyword query), and max_results, source_policy and fetch_policy go inside advanced_settings; sending only objective, or sending those fields at the top level, returns a 422. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths. If you are evaluating Parallel Search or comparing it with other search APIs, read How to Eval Parallel Search (https://docs.parallel.ai/search/evaluating-search.md) before you build the harness, especially its Common pitfalls section.","colors":{"primary":"#FB631B","light":"#fcfcfa","dark":"#1d1b16"},"logo":{"light":"https://mintcdn.com/parallel-6fabab31-mtje7p526we/ODrEI5O3l6nnvEZD/logo/wordmark_light.svg?fit=max\u0026auto=format\u0026n=ODrEI5O3l6nnvEZD\u0026q=85\u0026s=955d1146a212bea2279ca4ee6916b8ae","dark":"https://mintcdn.com/parallel-6fabab31-mtje7p526we/ODrEI5O3l6nnvEZD/logo/wordmark_dark.svg?fit=max\u0026auto=format\u0026n=ODrEI5O3l6nnvEZD\u0026q=85\u0026s=0039edb690a1759b9276a8691e19bf84"},"favicon":"https://mintcdn.com/parallel-6fabab31-mtje7p526we/dsxqJ8pzmudWCd39/favicon.svg?fit=max\u0026auto=format\u0026n=dsxqJ8pzmudWCd39\u0026q=85\u0026s=41982ed7e9fa034a1be0b73fb7294e48","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["python","typescript","curl"]}},"appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"API Playground","href":"https://platform.parallel.ai"}},"footer":{"socials":{"x":"https://x.com/p0","github":"https://github.com/parallel-web/parallel-cookbook","linkedin":"https://www.linkedin.com/company/parallel-web/about"},"links":[{"header":"Privacy","items":[{"label":"Cookie preferences","href":"#cookie-preferences"}]}]},"styling":{"eyebrows":"section","codeblocks":"system","latex":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Get API Key","icon":"key","href":"https://platform.parallel.ai"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"https://docs.parallel.ai/public-openapi.json"},{"anchor":"Python SDK","icon":"python","href":"https://pypi.org/project/parallel-web/"},{"anchor":"TypeScript SDK","icon":"js","href":"https://www.npmjs.com/package/parallel-web"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"parallel-6fabab31-mtje7p526we","hasAudioNarration":false,"actualSubdomain":"parallel-6fabab31-mtje7p526we","customDomains":["docs.parallel.ai"],"gitSource":{"type":"github","owner":"shapleyai","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af1fefc77b2275ecbcdc250","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Documentation","count":124},{"language":"default","tag":"Web Agents","count":45},{"language":"default","tag":"API Reference","count":39},{"language":"default","tag":"Features","count":23},{"language":"default","tag":"FindAll","count":22},{"language":"default","tag":"Web Tools","count":21},{"language":"default","tag":"Developer Tools","count":18},{"language":"default","tag":"Task","count":17},{"language":"default","tag":"Additional Resources","count":15},{"language":"default","tag":"Platform Integrations","count":14}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@parallel.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:'Gerstner Programm';src:url('https://assets.p0web.com/Gerstner-ProgrammRegular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'Gerstner Programm';src:url('https://assets.p0web.com/Gerstner-ProgrammMedium.woff2') format('woff2');font-weight:500;font-style:normal;font-display:swap}body,html{font-family:'Gerstner Programm', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif}@font-face{font-family:'FT System Mono';src:url('https://assets.p0web.com/FTSystemMono-Regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'FT System Mono';src:url('https://assets.p0web.com/FTSystemMono-Medium.woff2') format('woff2');font-weight:500;font-style:normal;font-display:swap}code,pre,.code,[class*=\"language-\"],kbd,samp,tt{font-family:'FT System Mono', monospace!important}h1,h2,h3,h4,h5,h6{font-weight:500!important}h1,h2,h3,h4,h5,h6{background:none!important;background-color:transparent!important;background-image:none!important}h1 mark,h2 mark,h3 mark,h4 mark,h5 mark,h6 mark{background:none!important;background-color:transparent!important;color:inherit!important}.font-normal h1,.font-normal h2,.font-normal h3{font-weight:400!important}pre,code,[id*=\"code-group\"],.not-prose,[class*=\"codeblock\"],[role=\"tabpanel\"],.mint-card,[class*=\"Card\"],.rounded-xl,.rounded-lg,.rounded-2xl{border-radius:0.375rem!important}.flex.flex-col.not-prose.relative.overflow-hidden{border-radius:0.375rem!important}[role=\"tab\"][aria-selected=\"true\"],[role=\"tab\"][data-headlessui-state=\"selected\"]{color:#FB631B!important;border-color:#FB631B!important}[role=\"tab\"][aria-selected=\"true\"] .absolute,[role=\"tab\"][data-headlessui-state=\"selected\"] .absolute{border-color:#FB631B!important}.dark .codeblock-dark,.dark [class*=\"codeblock\"],.dark pre{background-color:#1d1b16!important}[class*=\"codeblock\"],.not-prose{background-color:#fcfcfa!important}.dark [class*=\"codeblock\"],.dark .not-prose{background-color:#1d1b16!important}.bg-white\\/60{background-color:#fcfcfa!important}.dark .bg-codeblock,.dark .codeblock-dark{background-color:#1d1b16!important}#pagination{display:none}.dark{--bg-color: #1d1b16}.dark .example-panel,.dark [class*=\"example-panel\"]{background-color:transparent!important}.dark .example-button{background-color:transparent!important;background-image:none!important}.dark .example-button.text-white{background-color:#fb631b!important}.dark [class*=\"Card\"],.dark .mint-card,.dark a[href]>div{background-color:transparent!important;background-image:none!important}.dark [class*=\"Card\"]:hover,.dark .mint-card:hover,.dark a[href]:hover>div,.dark a[href]>div:hover{background-color:transparent!important;background-image:none!important}.dark .rounded-md.border{background-color:transparent!important}[class*=\"Card\"],.mint-card,[class*=\"Card\"] h1,[class*=\"Card\"] h2,[class*=\"Card\"] h3,[class*=\"Card\"] h4{background:none!important;background-color:transparent!important;background-image:none!important}[class*=\"Card\"]>div,.mint-card>div,[role=\"group\"]>a>div{background:none!important;background-color:transparent!important;background-image:none!important}[class*=\"Card\"] [class*=\"title\"],.mint-card [class*=\"title\"]{background:none!important;background-color:transparent!important}[class*=\"Card\"] h3,[class*=\"Card\"] h4,.mint-card h3,.mint-card h4{font-size:1.125rem!important;font-weight:600!important;margin-bottom:0.5rem!important}*:not(pre):not(code):not([class*=\"language-\"]):not(.token){text-decoration-color:inherit!important}mark:not(pre mark):not(code mark),::selection:not(pre ::selection):not(code ::selection){background:none!important;background-color:transparent!important}*:not(pre):not(code):not([class*=\"language-\"]):not(.token)::before,*:not(pre):not(code):not([class*=\"language-\"]):not(.token)::after{background:inherit!important}[data-card],[data-card-title],.card,.card-title{background:none!important;background-color:transparent!important;background-image:none!important}a[href] h1,a[href] h2,a[href] h3,a[href] h4{text-decoration:none!important;background:none!important;background-color:transparent!important}header nav button,header [role=\"navigation\"] a,header [role=\"navigation\"] button,[data-tabs] a,[data-tabs] button,nav[data-orientation=\"horizontal\"] a,nav[data-orientation=\"horizontal\"] button{font-size:1.25rem!important}article ul:not(nav ul):not([role=\"navigation\"] ul),.prose ul:not(nav ul):not([role=\"navigation\"] ul){list-style-type:disc;list-style-position:outside;padding-left:1.5rem}article ol:not(nav ol):not([role=\"navigation\"] ol),.prose ol:not(nav ol):not([role=\"navigation\"] ol){list-style-type:decimal;list-style-position:outside;padding-left:1.5rem}article li:not(nav li):not([role=\"navigation\"] li),.prose li:not(nav li):not([role=\"navigation\"] li){display:list-item;margin-left:0.5rem}nav ul,nav ol,nav li,[role=\"navigation\"] ul,[role=\"navigation\"] ol,[role=\"navigation\"] li,aside ul,aside ol,aside li{list-style-type:none!important}@media (min-width: 1024px){#content-container{max-width:none!important}}.pricing-summary th:first-child{width:28%}.pricing-summary th:nth-child(2){width:48%}.example-panel pre{max-height:340px;overflow-y:auto;overflow-x:hidden;white-space:pre-wrap;word-break:break-word;scrollbar-gutter:stable}.example-panel .code-block>.print\\:hidden{display:none!important}.example-panel pre::-webkit-scrollbar{width:8px}.example-panel pre::-webkit-scrollbar-thumb{background:rgba(0, 0, 0, 0.22);border-radius:4px;border:1px solid transparent;background-clip:padding-box}.dark .example-panel pre::-webkit-scrollbar-thumb{background:rgba(255, 255, 255, 0.22);background-clip:padding-box}.example-panel pre::-webkit-scrollbar-track{background:transparent}.example-tab-active{background-color:#eeeeee!important}.dark .example-tab-active{background-color:rgba(255, 255, 255, 0.06)!important}.example-tab-list,.example-tab-list li{padding:0!important;margin:0!important;list-style:none!important}.example-tab-list li{display:block!important}.example-panel .code-block{margin-top:0!important;margin-bottom:0!important}.home-panel-link{font-size:0.875rem;color:#4b5563;transition:color 0.15s}.home-panel-link:hover{color:#FB631B}.dark .home-panel-link{color:#9ca3af}.dark .home-panel-link:hover{color:#FB631B}.min-h-\\[260px\\]{min-height:260px}.bg-\\[\\#f6f6f6\\]{background-color:#f6f6f6}.bg-\\[\\#434343\\]{background-color:#434343}.hover\\:bg-\\[\\#2a2a2a\\]:hover{background-color:#2a2a2a}.border-\\[\\#e5e5e5\\]{border-color:#e5e5e5}.dark .dark\\:bg-\\[\\#1a1a1a\\]{background-color:#1a1a1a}.dark .dark\\:border-\\[\\#2a2a2a\\]{border-color:#2a2a2a}.dark .dark\\:bg-\\[\\#111\\]{background-color:#111}.bg-gray-50\\/60{background-color:rgb(249 250 251 / 0.6)}.dark .dark\\:bg-white\\/\\[0\\.02\\]{background-color:rgb(255 255 255 / 0.02)}.text-\\[12px\\]{font-size:12px}.text-\\[13px\\]{font-size:13px}@media (min-width: 1024px){.lg\\:w-\\[262px\\]{width:262px}.lg\\:p-5{padding:1.25rem}.lg\\:grid-cols-4{grid-template-columns:repeat(4, minmax(0, 1fr))}.lg\\:border-r{border-right-width:1px}.lg\\:border-b-0{border-bottom-width:0}.lg\\:border-gray-200{border-color:rgb(229 231 235)}.dark .lg\\:dark\\:border-\\[\\#2a2a2a\\]{border-color:#2a2a2a}}html[data-current-path=\"/getting-started/overview\"] [class*=\"max-w-6xl\"]>div:last-child{max-width:none!important}html[data-current-path=\"/getting-started/overview\"] header#header{display:none!important}html[data-current-path=\"/getting-started/overview\"] h2.font-bold{font-weight:700!important}html[data-current-path=\"/getting-started/overview\"] .mdx-content{margin-top:0!important}html[data-current-path=\"/getting-started/overview\"] .mdx-content h2{margin-top:0!important}html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt code{font-family:'FT System Mono', monospace!important;font-size:14px!important;font-weight:400!important;line-height:1.6!important}html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:hover,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:focus,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:active,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:visited{color:rgb(5, 80, 174)!important;font-weight:400!important;text-decoration:none!important;border-bottom:0!important;box-shadow:none!important;background-image:none!important}.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:hover,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:focus,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:active,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:visited,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:hover,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:focus,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:active,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:visited{color:#79c0ff!important}.prose a:not([class*=\"card\"]):not([class*=\"button\"]){font-weight:400!important}.pw-consent{position:fixed;bottom:1rem;left:1rem;right:1rem;z-index:2147483000;max-height:calc(100dvh - 2rem);overflow-y:auto;border-radius:4px;background:rgba(34, 34, 34, 0.8);backdrop-filter:blur(6px);-webkit-backdrop-filter:blur(6px);padding:1rem;color:#fff;font-family:'Gerstner Programm', -apple-system, BlinkMacSystemFont, sans-serif;opacity:0;transform:translateY(12px);transition:opacity 0.4s cubic-bezier(0.6, 0, 0.2, 1), transform 0.4s cubic-bezier(0.6, 0, 0.2, 1)}.pw-consent[data-visible=\"true\"]{opacity:1;transform:translateY(0)}@media (min-width: 768px){.pw-consent{bottom:1.5rem;left:1.5rem;right:auto;width:300px}}.pw-consent__stack{display:flex;flex-direction:column;gap:1rem}.pw-consent__title{font-size:16px;font-weight:500;line-height:24px;letter-spacing:0.15px;margin:0;color:#fff}.pw-consent__body{font-size:13px;line-height:16px;letter-spacing:0.15px;margin:0;color:#fff}.pw-consent__body a,.pw-consent__linkbtn{color:#fff;text-decoration:underline;background:none;border:0;padding:0;font:inherit;cursor:pointer}.pw-consent__panel{display:none;flex-direction:column;gap:0.75rem;border-top:1px solid rgba(255, 255, 255, 0.15);padding-top:1rem}.pw-consent__panel[data-expanded=\"true\"]{display:flex}.pw-consent__row{display:flex;align-items:flex-start;justify-content:space-between;gap:0.75rem}.pw-consent__label{font-size:13px;line-height:16px;letter-spacing:0.15px;color:#fff}.pw-consent__hint{display:block;margin-top:2px;font-size:12px;line-height:15px;color:rgba(255, 255, 255, 0.55)}.pw-consent__always{flex-shrink:0;margin-top:2px;font-family:'FT System Mono', monospace;font-size:11px;line-height:16px;text-transform:uppercase;color:rgba(255, 255, 255, 0.55)}.pw-consent__toggle{position:relative;flex-shrink:0;margin-top:2px;width:34px;height:20px;border:0;border-radius:9999px;background:rgba(255, 255, 255, 0.25);cursor:pointer;transition:background-color 0.2s cubic-bezier(0.6, 0, 0.2, 1)}.pw-consent__toggle[aria-checked=\"true\"]{background:#fff}.pw-consent__knob{position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:9999px;background:#fff;transition:left 0.2s cubic-bezier(0.6, 0, 0.2, 1), background-color 0.2s}.pw-consent__toggle[aria-checked=\"true\"] .pw-consent__knob{left:16px;background:#222}.pw-consent__actions{display:flex;gap:1rem}.pw-consent__btn{flex:1 1 0;display:flex;align-items:center;justify-content:center;white-space:nowrap;border:0;border-radius:4px;background:#eee;color:#181818;padding:8px 16px;font-family:'FT System Mono', monospace;font-size:13px;line-height:16px;text-transform:uppercase;cursor:pointer;transition:background-color 0.2s}.pw-consent__btn:hover{background:#fff}.pw-consent__btn--save{margin-top:4px;width:100%}@media (prefers-reduced-motion: reduce){.pw-consent,.pw-consent__toggle,.pw-consent__knob,.pw-consent__btn{transition:none}}"}],"page":{"pagePath":"api-reference/memory/retrieve-memory","slug":"/api-reference/memory/retrieve-memory","pageMetadata":{"title":"Retrieve Memory","description":"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/retrieve","href":"/api-reference/memory/retrieve-memory","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Retrieve Memory","description":"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/retrieve","href":"/api-reference/memory/retrieve-memory","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/parallel-6fabab31-mtje7p526we/8bc4b1f689ce2d52/consent.js","/_mintlify/custom/parallel-6fabab31-mtje7p526we/07c1eb0ddac88dfe/link-tracking.js"],"openApiReferenceData":{"operation":{"tags":["Memory"],"summary":"Retrieve Memory","description":"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.","operationId":"retrieve_memory_v1beta_memory_retrieve_post","requestBody":"4f0094ae-4150-44ad-b69f-45366c428021","responses":{"200":"42032580-e511-413f-b2ad-18a53192da60","422":"cd3e5c1a-0c43-4095-970c-406961a55a10"},"method":"post","type":"path","servers":["d84a1bbe-4462-4f37-aa5a-53ab9326f0ae"],"security":["e2b86466-cf4e-4c8b-b08a-8b2161a87db2"],"path":"/v1beta/memory/retrieve","baseUrlOptions":["https://api.parallel.ai"],"title":"Retrieve Memory","codeSamples":[],"requestExampleLanguages":["python","typescript","bash"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"query":{"oneOf":[{"type":"string","title":"Query","description":"Concise query describing the memories to retrieve. Empty queries return the most recent memories.","maxLength":500,"uniqueKey":"query.oneOf.0","typeLabel":"string"},{"type":"null","title":"Query","description":"Concise query describing the memories to retrieve. Empty queries return the most recent memories.","uniqueKey":"query.oneOf.1","typeLabel":"null"}],"uniqueKey":"query","typeLabel":"string | null"},"limit":{"type":"integer","maximum":25,"minimum":1,"title":"Limit","description":"Maximum number of memories to return.","default":10,"uniqueKey":"limit","typeLabel":"integer"},"kind":{"oneOf":[{"type":"string","title":"Kind","description":"Filter memories by kind: `task`, `monitor`, or `findall`.","enum":["task","monitor","findall"],"uniqueKey":"kind.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Kind","description":"Filter memories by kind: `task`, `monitor`, or `findall`.","uniqueKey":"kind.oneOf.1","typeLabel":"null"}],"uniqueKey":"kind","typeLabel":"enum\u003cstring> | null"},"since":{"type":"string","title":"Since","description":"Only return memories sourced from task, monitor, or FindAll runs completed at or after this RFC 3339 timestamp.","format":"date-time","example":"2026-07-15T17:30:00Z","uniqueKey":"since","typeLabel":"string\u003cdate-time>"},"memory_scope_key":{"oneOf":[{"type":"string","title":"Memory Scope Key","description":"User-provided key identifying the memory scope to use. Omit to use personal memory, if available.","maxLength":128,"minLength":1,"pattern":"^[a-zA-Z0-9_-]+$","uniqueKey":"memory_scope_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Memory Scope Key","description":"User-provided key identifying the memory scope to use. Omit to use personal memory, if available.","uniqueKey":"memory_scope_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"memory_scope_key","typeLabel":"string | null"}},"type":"object","title":"MemoryRetrieveRequest","uniqueKey":"","typeLabel":"MemoryRetrieveRequest · object"},"examples":{"Example":{"title":"Example","value":{"query":"\u003cstring>","limit":10,"since":"2026-07-15T17:30:00Z","memory_scope_key":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"42032580-e511-413f-b2ad-18a53192da60":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"results":{"items":{"oneOf":[{"type":"object","title":"TaskMemoryResult","required":["id","updated_at","input_excerpt","output_excerpt"],"properties":{"id":{"type":"string","title":"Id","description":"ID of the task run.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.0.id","typeLabel":"string"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When the run completed, as an RFC 3339 timestamp.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"input_excerpt":{"type":"string","title":"Input Excerpt","description":"Preview of the run's input. May be truncated.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.0.input_excerpt","typeLabel":"string"},"output_excerpt":{"type":"string","title":"Output Excerpt","description":"Preview of the run's output. May be truncated.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.0.output_excerpt","typeLabel":"string"},"kind":{"type":"string","const":"task","title":"Kind","default":"task","uniqueKey":"results.items.[INDEX].oneOf.0.kind","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].oneOf.0","typeLabel":"TaskMemoryResult · object"},{"type":"object","title":"MonitorMemoryResult","required":["id","updated_at","input_excerpt","status"],"properties":{"id":{"type":"string","title":"Id","description":"ID of the monitor.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.id","typeLabel":"string"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When the monitor last ran, as an RFC 3339 timestamp.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.updated_at","typeLabel":"string\u003cdate-time>"},"input_excerpt":{"type":"string","title":"Input Excerpt","description":"Preview of the monitor's query. May be truncated.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.input_excerpt","typeLabel":"string"},"status":{"type":"string","enum":["active","cancelled"],"title":"Status","description":"Current status of the monitor.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.status","typeLabel":"enum\u003cstring>"},"kind":{"type":"string","const":"monitor","title":"Kind","default":"monitor","uniqueKey":"results.items.[INDEX].oneOf.1.kind","typeLabel":"string"},"matched_events":{"items":{"properties":{"event_id":{"type":"string","title":"Event Id","description":"ID of the monitor event.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.matched_events.items.[INDEX].event_id","typeLabel":"string"},"event_group_id":{"type":"string","title":"Event Group Id","description":"ID of the execution that produced this event.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.matched_events.items.[INDEX].event_group_id","typeLabel":"string"},"detected_at":{"type":"string","format":"date-time","title":"Detected At","description":"When the event was detected, as an RFC 3339 timestamp.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.matched_events.items.[INDEX].detected_at","typeLabel":"string\u003cdate-time>"},"excerpt":{"type":"string","title":"Excerpt","description":"Excerpt of the monitor event. May be truncated.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.1.matched_events.items.[INDEX].excerpt","typeLabel":"string"}},"type":"object","required":["event_id","event_group_id","detected_at","excerpt"],"title":"MonitorMemoryEvent","uniqueKey":"results.items.[INDEX].oneOf.1.matched_events.items.[INDEX]","typeLabel":"MonitorMemoryEvent · object"},"type":"array","title":"Matched Events","description":"Detected events matching the retrieval query, ordered by relevance with more recent events favored. For an empty query, events are ordered by recency.","uniqueKey":"results.items.[INDEX].oneOf.1.matched_events","typeLabel":"MonitorMemoryEvent · object[]"}},"uniqueKey":"results.items.[INDEX].oneOf.1","typeLabel":"MonitorMemoryResult · object"},{"type":"object","title":"FindAllMemoryResult","required":["id","updated_at","input_excerpt","matched_count"],"properties":{"id":{"type":"string","title":"Id","description":"ID of the FindAll run.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.2.id","typeLabel":"string"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When the FindAll result was last updated, as an RFC 3339 timestamp.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.2.updated_at","typeLabel":"string\u003cdate-time>"},"input_excerpt":{"type":"string","title":"Input Excerpt","description":"Preview of the run's objective. May be truncated.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.2.input_excerpt","typeLabel":"string"},"matched_count":{"type":"integer","title":"Matched Count","description":"Current number of matched entities.","isRequired":true,"uniqueKey":"results.items.[INDEX].oneOf.2.matched_count","typeLabel":"integer"},"kind":{"type":"string","const":"findall","title":"Kind","default":"findall","uniqueKey":"results.items.[INDEX].oneOf.2.kind","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].oneOf.2","typeLabel":"FindAllMemoryResult · object"}],"uniqueKey":"results.items.[INDEX]","typeLabel":"TaskMemoryResult · object | MonitorMemoryResult · object | FindAllMemoryResult · object"},"type":"array","title":"Results","isRequired":true,"uniqueKey":"results","typeLabel":"(TaskMemoryResult · object | MonitorMemoryResult · object | FindAllMemoryResult · object)[]"}},"type":"object","required":["results"],"title":"MemoryRetrieveResponse","uniqueKey":"","typeLabel":"MemoryRetrieveResponse · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"id":"\u003cstring>","updated_at":"2023-11-07T05:31:56Z","input_excerpt":"\u003cstring>","output_excerpt":"\u003cstring>","kind":"task"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"cd3e5c1a-0c43-4095-970c-406961a55a10":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e2b86466-cf4e-4c8b-b08a-8b2161a87db2":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"d84a1bbe-4462-4f37-aa5a-53ab9326f0ae":{"url":"https://api.parallel.ai","description":"Parallel API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"public-openapi.json"},"subdomain":"parallel-6fabab31-mtje7p526we","siteName":"Parallel","title":"Retrieve Memory - Parallel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T22:53:35.181Z","originalFileLocation":"api-reference/memory/retrieve-memory.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=\"light\"}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=\"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Parallel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve Memory - Parallel\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Parallel\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.parallel.ai/api-reference/memory/retrieve-memory\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://parallel-6fabab31-mtje7p526we.mintlify.site/_mintlify/api/og/v2?division=Memory\u0026amp;title=Retrieve+Memory\u0026amp;description=Retrieves+relevant+or+recent+runs+from+the+selected+memory.+Provide+a+query+to+rank+results+by+relevance%3B+leave+it+empty+to+return+the+most+recent+runs.\u0026amp;theme=106af9efc399e2ef4c618350\u0026amp;signature=c58ec7af3adc679a72b5a37197b88e5473e9d2fbacaf436e7e7cb05a60421a78\">\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=\"Retrieve Memory - Parallel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://parallel-6fabab31-mtje7p526we.mintlify.site/_mintlify/api/og/v2?division=Memory\u0026amp;title=Retrieve+Memory\u0026amp;description=Retrieves+relevant+or+recent+runs+from+the+selected+memory.+Provide+a+query+to+rank+results+by+relevance%3B+leave+it+empty+to+return+the+most+recent+runs.\u0026amp;theme=106af9efc399e2ef4c618350\u0026amp;signature=c58ec7af3adc679a72b5a37197b88e5473e9d2fbacaf436e7e7cb05a60421a78\">\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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Parallel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FB631B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.parallel.ai/api-reference/memory/retrieve-memory\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/memory/retrieve-memory.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.parallel.ai/#organization\",\"name\":\"Parallel\",\"url\":\"https://docs.parallel.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/parallel-6fabab31-mtje7p526we/ODrEI5O3l6nnvEZD/logo/wordmark_light.svg?fit=max\u0026auto=format\u0026n=ODrEI5O3l6nnvEZD\u0026q=85\u0026s=955d1146a212bea2279ca4ee6916b8ae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.parallel.ai#website\",\"name\":\"Parallel\",\"url\":\"https://docs.parallel.ai\",\"publisher\":{\"@id\":\"https://docs.parallel.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory#webpage\",\"url\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory\",\"name\":\"Retrieve Memory\",\"description\":\"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.\",\"dateModified\":\"2026-11-06T22:53:35.181Z\",\"isPartOf\":{\"@id\":\"https://docs.parallel.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Memory\",\"item\":\"https://docs.parallel.ai/api-reference/memory/clear-memory\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve Memory\",\"item\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory#apireference\",\"headline\":\"Retrieve Memory\",\"name\":\"Retrieve Memory\",\"description\":\"Retrieves relevant or recent runs from the selected memory. Provide a query to rank results by relevance; leave it empty to return the most recent runs.\",\"url\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory\",\"mainEntityOfPage\":{\"@id\":\"https://docs.parallel.ai/api-reference/memory/retrieve-memory#webpage\"},\"dateModified\":\"2026-11-06T22:53:35.181Z\",\"publisher\":{\"@id\":\"https://docs.parallel.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.parallel.ai#website\"}}]}\u003c/script>","siteName":"Parallel","nav":{"global":{"anchors":[{"anchor":"Get API Key","icon":"key","href":"https://platform.parallel.ai"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"https://docs.parallel.ai/public-openapi.json"},{"anchor":"Python SDK","icon":"python","href":"https://pypi.org/project/parallel-web/"},{"anchor":"TypeScript SDK","icon":"js","href":"https://www.npmjs.com/package/parallel-web"}]},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/getting-started/overview"}]},{"tab":"API Reference","icon":"magnifying-glass","groups":[{"group":"Search","pages":[{"title":"Search","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/search","href":"/api-reference/search/search"}]},{"group":"Image Search","pages":[{"title":"Image search","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/images/search","href":"/api-reference/image-search/image-search"}]},{"group":"Place Search","pages":[{"title":"Place search","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/places/search","href":"/api-reference/place-search/place-search"}]},{"group":"Extract","pages":[{"title":"Extract","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/extract","href":"/api-reference/extract/extract"}]},{"group":"Decisions","pages":[{"title":"Decisions","deprecated":null,"version":null,"sidebarTitle":"Decisions","openapi":"/public-openapi.json post /v1/decisions","href":"/api-reference/decisions/decisions"}]},{"group":"Tasks","pages":[{"title":"Create Task Group","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/tasks/groups","href":"/api-reference/tasks/create-task-group"},{"title":"Retrieve Task Group","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}","href":"/api-reference/tasks/retrieve-task-group"},{"title":"Stream Task Group Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}/events","href":"/api-reference/tasks/stream-task-group-events"},{"title":"Fetch Task Group Runs","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}/runs","href":"/api-reference/tasks/fetch-task-group-runs"},{"title":"Add Runs to Task Group","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/tasks/groups/{taskgroup_id}/runs","href":"/api-reference/tasks/add-runs-to-task-group"},{"title":"Retrieve Task Group Run","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}/runs/{run_id}","href":"/api-reference/tasks/retrieve-task-group-run"},{"title":"Create Task Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/tasks/runs","href":"/api-reference/tasks/create-task-run"},{"title":"Retrieve Task Run","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}","href":"/api-reference/tasks/retrieve-task-run"},{"title":"Stream Task Run Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}/events","href":"/api-reference/tasks/stream-task-run-events"},{"title":"Retrieve Task Run Input","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}/input","href":"/api-reference/tasks/retrieve-task-run-input"},{"title":"Retrieve Task Run Result","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}/result","href":"/api-reference/tasks/retrieve-task-run-result"}]},{"group":"FindAll","pages":[{"title":"Fast Entity Search","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/entity-search","href":"/api-reference/findall/fast-entity-search"},{"title":"Ingest FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/ingest","href":"/api-reference/findall/ingest-findall-run"},{"title":"Create FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs","href":"/api-reference/findall/create-findall-run"},{"title":"Retrieve FindAll Run Status","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}","href":"/api-reference/findall/retrieve-findall-run-status"},{"title":"Cancel FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs/{findall_id}/cancel","href":"/api-reference/findall/cancel-findall-run"},{"title":"Add Enrichment to FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs/{findall_id}/enrich","href":"/api-reference/findall/add-enrichment-to-findall-run"},{"title":"Stream FindAll Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}/events","href":"/api-reference/findall/stream-findall-events"},{"title":"Extend FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs/{findall_id}/extend","href":"/api-reference/findall/extend-findall-run"},{"title":"FindAll Run Result","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}/result","href":"/api-reference/findall/findall-run-result"},{"title":"Get FindAll Run Schema","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}/schema","href":"/api-reference/findall/get-findall-run-schema"}]},{"group":"Monitor","pages":[{"title":"List Monitors","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors","href":"/api-reference/monitor/list-monitors"},{"title":"Create Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors","href":"/api-reference/monitor/create-monitor"},{"title":"Monitor Stats","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors/stats","href":"/api-reference/monitor/monitor-stats"},{"title":"Retrieve Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors/{monitor_id}","href":"/api-reference/monitor/retrieve-monitor"},{"title":"Cancel Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors/{monitor_id}/cancel","href":"/api-reference/monitor/cancel-monitor"},{"title":"List Monitor Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors/{monitor_id}/events","href":"/api-reference/monitor/list-monitor-events"},{"title":"Trigger Monitor Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors/{monitor_id}/trigger","href":"/api-reference/monitor/trigger-monitor-run"},{"title":"Update Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors/{monitor_id}/update","href":"/api-reference/monitor/update-monitor"}]},{"group":"Memory","pages":[{"title":"Clear Memory","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/clear","href":"/api-reference/memory/clear-memory"},{"title":"Evict from Memory","description":"Removes a task run, monitor, or FindAll run from the selected memory without deleting the original resource.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/evict","href":"/api-reference/memory/evict-from-memory"},{"title":"Retrieve Memory","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/retrieve","href":"/api-reference/memory/retrieve-memory"}]},{"group":"Chat API (Beta)","pages":[{"title":"Chat Completions","description":"Chat completions.\n\nThis endpoint can be used to get realtime chat completions. It can also be used\nwith the Task API processors to get structured, research outputs via a chat\ninterface.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/chat/completions","href":"/api-reference/chat-api-beta/chat-completions"}]},{"group":"Responses API","pages":[{"title":"Create Response","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/responses","href":"/api-reference/responses-api/create-response"}]}]},{"tab":"Account API","icon":"gear","pages":[{"title":"Account API","href":"/service-api/balance/get-balance"}]},{"tab":"API Reference (legacy)","icon":"magnifying-glass","hidden":true,"pages":[{"title":"API Reference (legacy)","href":"/api-reference/legacy/search-beta/search"}]},{"tab":"Changelog","icon":"clock","pages":[{"title":"Changelog","href":"/resources/changelog"}]}]},"basePath":"","title":"Retrieve Memory - Parallel","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}