Conversations

The first response creates a conversation and returns its public identifier.

const first = await client.responses.create({ message: "Analyze this lead" });
const next = await client.responses.create({
  message: "Prepare the next step",
  conversationId: first.conversationId,
});

const history = await client.conversations.getMessages(next.conversationId, { page: 1, pageSize: 50 });
await client.conversations.delete(next.conversationId);

Keep the latest identifier in your own session or data model and never share it between users who should not share context. Deletion is permanent. The public API does not list, explicitly create, or rename conversations.

History exposes page, pageSize, total, and hasMore, with at most 100 messages per page. externalReference correlates client records; idempotencyKey prevents duplicate generations. Conflicts produce typed functional errors.