ConversationsResource class

Resource for conversations operations.

The Conversations API provides server-side conversation state management for the Responses API. This allows creating, storing, and retrieving conversation items without the 30-day TTL.

Example

// Create a conversation
final conversation = await client.conversations.create(
  ConversationCreateRequest(
    items: [MessageItem.userText('Hello!')],
    metadata: {'user_id': 'user_123'},
  ),
);

// Use with Responses API
final response = await client.responses.create(
  CreateResponseRequest(
    model: 'gpt-4o',
    input: ResponseInput.text('Continue our conversation'),
  ),
);

// Add items to the conversation
await client.conversations.items.create(
  conversation.id,
  ItemsCreateRequest(items: [
    MessageItem.userText('What is the weather?'),
  ]),
);

// List conversation items
final items = await client.conversations.items.list(conversation.id);

// Clean up
await client.conversations.delete(conversation.id);