Returns a paginated list of messages within a conversation, ordered by sequence number. Use continuation_token to page through the full history.
Permission required: project:conv_read
Path Parameters
Query Parameters
Number of messages to return per page
Token from a previous response to fetch the next page of results
Response
Show Paginated message list
Array of message objects
Unique message identifier
Array of content blocks that make up the message body
Block type: TEXT, FILE, IMAGE, THINKING, TOOL_USE, TOOL_RESULT
Text content (present when block_type is TEXT)
Arbitrary key-value metadata attached to the message
Caller-provided timestamp for when the message originally occurred (ISO 8601)
ID of the conversation this message belongs to
Position of this message within the conversation, starting at 1
ID of the actor who sent this message
Type of the actor: HUMAN or ASSISTANT
Token to retrieve the next page. null when there are no more results.