> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Parallel Memory to Build on Past Research

> Let your agents search and reuse past Task, Monitor, and FindAll results so new research builds on work you have already done.

<div className="sr-only" aria-hidden="false">
  For AI agents: a documentation index is available at [https://docs.parallel.ai/llms.txt](https://docs.parallel.ai/llms.txt). The full text of all docs is at [https://docs.parallel.ai/llms-full.txt](https://docs.parallel.ai/llms-full.txt). You may also fetch any page as Markdown by appending `.md` to its URL or sending `Accept: text/markdown`.
</div>

Memory lets your agents build on research you've already done with Parallel.

When you use Parallel personally — through the [CLI](/integrations/cli), or
[third-party agents like Claude Code](/integrations/agent-skills) — your agents can search past
Task, Monitor, and FindAll results and reference them in new work.

This personal memory never changes the results of Task, FindAll, Monitor, or other API requests.

<Note>
  We're gradually rolling out memory over the coming weeks. As part of this rollout, memory will be
  enabled by default for some newly created organizations.
</Note>

## How memory works

Once memory is enabled, the inputs and outputs of supported Parallel runs are saved to your
personal memory.

When your agent starts new research, it can choose to search your memory for relevant past work.
Memory is never used automatically — your agent must explicitly retrieve it.

Only you and your personal agents can access your personal memory, and it follows you across the
agents that you use.

### Memory example

| #  | Task request                                                         | Without memory                                                                         | With memory                                                                                      |
| :- | :------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
| 1  | "Research the latest trends in data center buildouts in the midwest" | Parallel conducts a research task against the web to find data centers in the midwest. | Same as without memory — this is the first run, so there is nothing to build on.                 |
| 2  | "Which data centers came online in Ohio recently?"                   | Parallel conducts a research task against the web to find data centers in Ohio.        | Agent decides the previous query contains enough information to answer without further research. |

## Turn personal memory on

Members can turn on personal memory under **Settings → Account** once memory is enabled for their
organization.

During opt-in, you'll be shown the account keys that will contribute to your personal memory.

When memory is turned off, new memories will not be created. Existing memories are retained and
become available again if memory is turned back on.

You can also permanently delete your personal memory. This cannot be undone.

## Organization controls

Organization admins manage memory under **Settings → Organization**.

The organization setting controls whether members can use personal memory. Each member must still
opt in individually.

Turning memory off stops new memories from being created. Existing personal and application
memories are retained until they are permanently deleted.

Admins can permanently delete all personal and application memory. This cannot be undone.

## Taking advantage of memory

Use the [memory API](#api-reference) to take advantage of memory. Access the API using the
[Parallel CLI](/integrations/cli) or the [Parallel skill](/integrations/agent-skills).
Update to the latest version of the Parallel CLI:

```bash theme={"system"}
parallel-cli update
```

Update to the latest version of the skill:

```bash theme={"system"}
npx skills add parallel-web/parallel-agent-skills --skill parallel-memory
```

Ask your agents to "check what I've already researched with Parallel before starting."

## Building applications with memory

If you're a developer building on Parallel, you can also create application-scoped memory.

Application memory is opt-in per request. Runs are saved only when your application provides a
`memory_scope_key`. Each `memory_scope_key` maps to its own isolated memory bank.

You can set `memory_scope_key` when creating a [Task run](/api-reference/tasks/create-task-run), a
[FindAll run](/api-reference/findall/create-findall-run), or a
[Monitor](/api-reference/monitor/create-monitor).

## API reference

| Endpoint                                                     | Description                                                      |
| :----------------------------------------------------------- | :--------------------------------------------------------------- |
| [Retrieve Memory](/api-reference/memory/retrieve-memory)     | Search memories created by past Task, Monitor, and FindAll runs. |
| [Evict from Memory](/api-reference/memory/evict-from-memory) | Remove a specific source from a memory bank.                     |
| [Clear Memory](/api-reference/memory/clear-memory)           | Permanently delete the contents of a memory bank.                |