Skip to main content
Adds a conversation item to the session. Use it to provide user messages, function calls, or function call outputs that should become part of the conversation context. The server confirms with conversation.item.created. conversation.item.create → response.create: wait for the matching conversation.item.created before requesting a reply that uses the new message. Use the same sequence when returning a tool result.

Event fields

string
Client-generated id for this event.
string
required
Event type. Must be conversation.item.create.
string
Item after which the new item should be inserted. If omitted, the item is appended. Use root to insert at the beginning of the conversation.
object
required
A single item within the real-time conversation. Provide one of the variants below.
string
Server-assigned or client-provided conversation item id.
string
required
One of message, function_call, or function_call_output.
string
One of completed, incomplete, or in_progress. Usually returned by the server.
Message variant Message item with item.type: "message". Message item.role: string enum Use user for input from the person interacting with the avatar, or assistant for prior avatar replies. Define the character’s behavior in its Persona. For assistant messages, generated audio and video are delivered over RTC media tracks, and the text for spoken output streams through response.output_text.* events. Message item.content: array Message content parts. System messages typically use input_text; user messages typically use input_text, input_audio, and input_image; assistant messages typically use text parts. Message item.content[].type: string enum One of input_text, input_audio, input_image, or text. Message item.content[].text: optional string Text content. Used with input_text and text. Message item.content[].audio: optional string Base64-encoded audio. Used with input_audio. Message item.content[].transcript: optional string Optional transcript. Used with input_audio. Message item.content[].image_url: optional string Image URL. Used with input_image. Message item.content[].detail: optional string enum Image detail level of auto, low, or high. Used with input_image. Function call variant Function call item with item.type: "function_call". Function call item.call_id: optional string Function call id. Function call item.name: string Function name. Function call item.arguments: string JSON-encoded function arguments. Function call output variant Function call output item with item.type: "function_call_output". Function call output item.call_id: string Function call id this output belongs to. Function call output item.output: string Function output as a string.