# CosmosDBSaverSync

> **Class** in `langchain_azure_cosmosdb`

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

CosmosDB synchronous implementation of BaseCheckpointSaver.

Uses environment variables for connection configuration.

## Signature

```python
CosmosDBSaverSync(
    self,
    database_name: str,
    container_name: str,
    *,
    endpoint: str | None = None,
    key: str | None = None,
    cosmos_client_kwargs: dict[str, Any] | None = None,
)
```

## Description

**Environment Variables:**

COSMOSDB_ENDPOINT: CosmosDB endpoint URL (required).
COSMOSDB_KEY: CosmosDB access key (optional, uses
    DefaultAzureCredential if not provided).

**Example:**

>>> import os
>>> os.environ["COSMOSDB_ENDPOINT"] = (
...     "https://your-account.documents.azure.com:443/"
... )
>>> os.environ["COSMOSDB_KEY"] = "your_key"  # Optional
>>>
>>> checkpointer = CosmosDBSaverSync(
...     database_name="langgraph_db",
...     container_name="checkpoints",
... )

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `database_name` | `str` | Yes | Name of the CosmosDB database. |
| `container_name` | `str` | Yes | Name of the CosmosDB container. |

## Extends

- `BaseCheckpointSaver`

## Constructors

```python
__init__(
    self,
    database_name: str,
    container_name: str,
    *,
    endpoint: str | None = None,
    key: str | None = None,
    cosmos_client_kwargs: dict[str, Any] | None = None,
) -> None
```

| Name | Type |
|------|------|
| `database_name` | `str` |
| `container_name` | `str` |
| `endpoint` | `str \| None` |
| `key` | `str \| None` |
| `cosmos_client_kwargs` | `dict[str, Any] \| None` |


## Properties

- `container`
- `client`
- `database`
- `cosmos_serde`

## Methods

- [`close()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/_langgraph_checkpoint_store/CosmosDBSaverSync/close)
- [`from_conn_info()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/_langgraph_checkpoint_store/CosmosDBSaverSync/from_conn_info)
- [`put()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/_langgraph_checkpoint_store/CosmosDBSaverSync/put)
- [`put_writes()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/_langgraph_checkpoint_store/CosmosDBSaverSync/put_writes)
- [`get_tuple()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/_langgraph_checkpoint_store/CosmosDBSaverSync/get_tuple)
- [`list()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/_langgraph_checkpoint_store/CosmosDBSaverSync/list)

---

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