# StoreBackend

> **Class** in `deepagents`

📖 [View in docs](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend)

Backend that stores files in LangGraph's BaseStore (persistent).

Uses LangGraph's Store for persistent, cross-conversation storage.
Files are organized via namespaces and persist across all threads.

The namespace can include an optional assistant_id for multi-agent isolation.

## Signature

```python
StoreBackend(
    self,
    runtime: object = None,
    *,
    store: BaseStore | None = None,
    namespace: NamespaceFactory | None = None,
    file_format: FileFormat = 'v2',
)
```

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `runtime` | `object` | No | Deprecated - accepted for backward compatibility but ignored. Store and context are now obtained via `get_store()` / `get_runtime()`. (default: `None`) |
| `store` | `BaseStore \| None` | No | Optional `BaseStore` instance. When provided, this store is used directly. When `None` (the default), the store is obtained at call time via `get_store()`, which requires a LangGraph graph execution context. (default: `None`) |
| `namespace` | `NamespaceFactory \| None` | No | Optional callable that receives a `Runtime` and returns a namespace tuple for scoping store operations. Wildcards (`*`) are forbidden. If `None`, uses legacy assistant_id detection from metadata (deprecated).  Old-style callables that accept `BackendContext` still work but are deprecated and will be removed in `deepagents==0.7.0`. (default: `None`) |
| `file_format` | `FileFormat` | No | Storage format version. `"v1"` (default) stores content as `list[str]` (lines split on `\\n`) without an `encoding` field. `"v2"` stores content as a plain `str` with an `encoding` field. (default: `'v2'`) |

## Extends

- `BackendProtocol`

## Constructors

```python
__init__(
    self,
    runtime: object = None,
    *,
    store: BaseStore | None = None,
    namespace: NamespaceFactory | None = None,
    file_format: FileFormat = 'v2',
) -> None
```

| Name | Type |
|------|------|
| `runtime` | `object` |
| `store` | `BaseStore \| None` |
| `namespace` | `NamespaceFactory \| None` |
| `file_format` | `FileFormat` |


## Methods

- [`ls()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/ls)
- [`read()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/read)
- [`aread()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/aread)
- [`write()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/write)
- [`awrite()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/awrite)
- [`edit()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/edit)
- [`aedit()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/aedit)
- [`grep()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/grep)
- [`glob()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/glob)
- [`upload_files()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/upload_files)
- [`download_files()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/download_files)

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/7e70065200007896336f38fe905803e6763e8f85/libs/deepagents/deepagents/backends/store.py#L172)