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 a local conversation with metadata and optional item summaries.
Retrieve a conversation	Retrieve a conversation	Retrieve the metadata, status, and timestamps of a local conversation.
Update conversation metadata	Update conversation metadata	Replace all metadata of a local conversation.
Delete a conversation	Delete a conversation	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	Add an item summary containing a type, role, and status to a local conversation.
List conversation items	List conversation items	List item summaries in a local conversation.
Retrieve a conversation item	Retrieve a conversation item	Retrieve one item summary from a local conversation.
Delete a conversation item	Delete a conversation item	Delete an item from a local conversation. The item can no longer be retrieved.

Last updated on Sep 15, 2026