The messages array in an Exchange contains the conversation transcript between the user and the Assistant.
Message structure
Each message has these fields:
Field
Type
Description
message
string
The text content of the message
from
string
The emitter: "assistant" or "user"
time
string
ISO 8601 timestamp of the message
metadata
object
Timing, interruption, language, and Assistant information when available
Example: technical support conversation
This transcript records a technical support call about connection timeouts. Tool calls appear in Events.
Code
[ { "message": "Hi, welcome to the technical support, how may I assist you today?", "from": "assistant", "time": "2025-12-15T16:04:51.002484" }, { "message": "Hi, I'm having technical difficulties connecting to your service this morning and I'd like to report a bug.", "from": "user", "time": "2025-12-15T16:04:58.229180" }, { "message": "I'm sorry to hear that you're experiencing issues. Could you please describe the problem in more detail? What exactly happens when you try to connect?", "from": "assistant", "time": "2025-12-15T16:05:06.000673" }, { "message": "Well, I just get this timeout error after 30 seconds of trying to connect.", "from": "user", "time": "2025-12-15T16:05:23.036069" }, { "message": "I see. Let me check the current system status. One moment please.", "from": "assistant", "time": "2025-12-15T16:05:29.072161" }, { "message": "The system status appears to be normal. Let's try a few troubleshooting steps. Could you please check your internet connection? Maybe try restarting your router?", "from": "assistant", "time": "2025-12-15T16:05:38.046120" }, { "message": "Oh yeah, okay, I checked and actually it's on my end. Sorry. Thank you.", "from": "user", "time": "2025-12-15T16:05:46.068351" }, { "message": "You're welcome. If you have any other questions or need further assistance, feel free to ask. Have a great day!", "from": "assistant", "time": "2025-12-15T16:05:51.862629" }]
Usage notes
Messages are ordered chronologically by their time field
Timestamps use ISO 8601 and may include fractional seconds
If transcript post-processing is enabled, messages contains its output and rawMessages, when present, retains the live transcript.
Message metadata can include start and end offsets in seconds, interrupted, language, and assistant_id.
Tool invocations by the Assistant are recorded in the Events array, not in messages