# Conversation management

Create and manage conversation records, metadata, and item summaries. This group covers local conversations that have not been bound to an upstream model. These endpoints do not store message bodies or automatically send conversation content to a model; your application maintains message bodies and the context sent with model requests.

## Choose a task

| Task | Page | Description |
| --- | --- | --- |
| Create a conversation | [Create a conversation](create-conversation.md) | Create a local conversation with metadata and optional item summaries. |
| Retrieve a conversation | [Retrieve a conversation](get-conversation.md) | Retrieve the metadata, status, and timestamps of a local conversation. |
| Update conversation metadata | [Update conversation metadata](update-conversation.md) | Replace all metadata of a local conversation. |
| Delete a conversation | [Delete a conversation](delete-conversation.md) | Delete a local conversation. The conversation and its items can no longer be accessed through these endpoints. |
| Create a conversation item | [Create a conversation item](create-item.md) | Add an item summary containing a type, role, and status to a local conversation. |
| List conversation items | [List conversation items](list-items.md) | List item summaries in a local conversation. |
| Retrieve a conversation item | [Retrieve a conversation item](get-item.md) | Retrieve one item summary from a local conversation. |
| Delete a conversation item | [Delete a conversation item](delete-item.md) | Delete an item from a local conversation. The item can no longer be retrieved. |

```{toctree}
:hidden:
:maxdepth: 1

Create a conversation <create-conversation>
Retrieve a conversation <get-conversation>
Update conversation metadata <update-conversation>
Delete a conversation <delete-conversation>
Create a conversation item <create-item>
List conversation items <list-items>
Retrieve a conversation item <get-item>
Delete a conversation item <delete-item>
```
