# CosmosDBChatMessageHistory

> **Class** in `langchain_community`

📖 [View in docs](https://reference.langchain.com/python/langchain-community/chat_message_histories/cosmos_db/CosmosDBChatMessageHistory)

Chat message history backed by Azure CosmosDB.

## Signature

```python
CosmosDBChatMessageHistory(
    self,
    cosmos_endpoint: str,
    cosmos_database: str,
    cosmos_container: str,
    session_id: str,
    user_id: str,
    credential: Any = None,
    connection_string: Optional[str] = None,
    ttl: Optional[int] = None,
    cosmos_client_kwargs: Optional[dict] = None,
)
```

## Extends

- `BaseChatMessageHistory`

## Constructors

```python
__init__(
    self,
    cosmos_endpoint: str,
    cosmos_database: str,
    cosmos_container: str,
    session_id: str,
    user_id: str,
    credential: Any = None,
    connection_string: Optional[str] = None,
    ttl: Optional[int] = None,
    cosmos_client_kwargs: Optional[dict] = None,
)
```

| Name | Type |
|------|------|
| `cosmos_endpoint` | `str` |
| `cosmos_database` | `str` |
| `cosmos_container` | `str` |
| `session_id` | `str` |
| `user_id` | `str` |
| `credential` | `Any` |
| `connection_string` | `Optional[str]` |
| `ttl` | `Optional[int]` |
| `cosmos_client_kwargs` | `Optional[dict]` |


## Properties

- `cosmos_endpoint`
- `cosmos_database`
- `cosmos_container`
- `credential`
- `conn_string`
- `session_id`
- `user_id`
- `ttl`
- `messages`

## Methods

- [`prepare_cosmos()`](https://reference.langchain.com/python/langchain-community/chat_message_histories/cosmos_db/CosmosDBChatMessageHistory/prepare_cosmos)
- [`load_messages()`](https://reference.langchain.com/python/langchain-community/chat_message_histories/cosmos_db/CosmosDBChatMessageHistory/load_messages)
- [`add_message()`](https://reference.langchain.com/python/langchain-community/chat_message_histories/cosmos_db/CosmosDBChatMessageHistory/add_message)
- [`upsert_messages()`](https://reference.langchain.com/python/langchain-community/chat_message_histories/cosmos_db/CosmosDBChatMessageHistory/upsert_messages)
- [`clear()`](https://reference.langchain.com/python/langchain-community/chat_message_histories/cosmos_db/CosmosDBChatMessageHistory/clear)

---

[View source on GitHub](https://github.com/langchain-ai/langchain-community/blob/4b280287bd55b99b44db2dd849f02d66c89534d5/libs/community/langchain_community/chat_message_histories/cosmos_db.py#L22)