multi-turn conversation

Build back-and-forth conversations by including previous assistant and user turns in the messages array.

Syntax

claude-api
messages: [{ role: "user", ... }, { role: "assistant", ... }, { role: "user", ... }]

Example

claude-api
const messages = [
  { role: "user", content: "My name is Alice." },
  { role: "assistant", content: "Hello, Alice! How can I help you?" },
  { role: "user", content: "What is my name?" }
];

const response = await client.messages.create({
  model: "claude-opus-4-5",
  max_tokens: 256,
  messages
});
// Response: "Your name is Alice."