# CosmosDBSaver

> **Class** in `langchain_azure_cosmosdb`

📖 [View in docs](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver)

Asynchronous CosmosDB implementation of BaseCheckpointSaver.

Uses the native ``azure.cosmos.aio`` async client for non-blocking I/O.
Sync methods (``get_tuple``, ``list``, ``put``, ``put_writes``)
are provided for compatibility and delegate to the async implementations
via ``asyncio.run_coroutine_threadsafe``.

## Signature

```python
CosmosDBSaver(
    self,
    container: Any,
    *,
    serde: SerializerProtocol | None = None,
)
```

## Description

Use ``from_conn_info`` to create an instance:

**Example:**

>>> async with CosmosDBSaver.from_conn_info(
...     endpoint="https://your-account.documents.azure.com:443/",
...     key="your_key",
...     database_name="langgraph_db",
...     container_name="checkpoints",
... ) as saver:
...     config = {"configurable": {"thread_id": "thread-1"}}
...     checkpoint_tuple = await saver.aget_tuple(config)

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `container` | `Any` | Yes | An already-created async ``ContainerProxy`` instance. |
| `serde` | `SerializerProtocol \| None` | No | Optional custom serializer. (default: `None`) |

## Extends

- `BaseCheckpointSaver`

## Constructors

```python
__init__(
    self,
    container: Any,
    *,
    serde: SerializerProtocol | None = None,
) -> None
```

| Name | Type |
|------|------|
| `container` | `Any` |
| `serde` | `SerializerProtocol \| None` |


## Properties

- `container`
- `cosmos_serde`

## Methods

- [`from_conn_info()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/from_conn_info)
- [`aget_tuple()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/aget_tuple)
- [`alist()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/alist)
- [`aput()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/aput)
- [`aput_writes()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/aput_writes)
- [`get_tuple()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/get_tuple)
- [`list()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/list)
- [`put()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/put)
- [`put_writes()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_checkpoint_store/CosmosDBSaver/put_writes)

---

[View source on GitHub](https://github.com/langchain-ai/langchain-azure/blob/e62c2a55aaa0942fdac739b4066011953b80018e/libs/azure-cosmosdb/src/langchain_azure_cosmosdb/aio/_langgraph_checkpoint_store.py#L43)