Conversation Get
conversation_getFull Description
Get a conversation's metadata and messages. Use lastN to limit messages, roles to filter by message role (roles filter is applied before lastN), and includeTimestamps to emit ISO createdAt per message.
Parameters (1 required, 4 optional)
conversationIdstringThe conversation ID
includeTimestampsbooleanInclude createdAt ISO timestamp per message when present.
includeToolOutputbooleanWhen true, include tool output for allow-listed tools (currently: render_chart) on each message as `toolCalls[]` with shape { toolCallId, toolName, output } (or `error` on failure). Only returned when the conversation's agent currently has the tool configured. Tool inputs are not returned. Outputs larger than 20KB are replaced with { truncated: true, originalBytes: <n> }. Default: false.
lastNintegerReturn only the last N messages (default: all). Applied after roles filter.
rolesarrayFilter messages by role. Omit for all roles. Pair with lastN: 1, roles: ['assistant'] as a lightweight conversation_get_last_message alternative (no streaming status).