ai_conversation_list
List the saved AI conversations for one subject, or fetch one with its messages. subject_type and subject_id are required so conversation history never falls back to a project-wide view. Without conversation_id it lists (most-recently-updated first; each row includes id, created_at, updated_at, message_count, summarized_message_count, and summary_updated_at). With conversation_id it fetches that single conversation — returns its summary (rolling text from compaction:"summarize", null otherwise), summary_updated_at, and the message log in chronological order. By default a fetch returns only live (non-summarized) messages, matching what the model sees on the next call; include_summarized:true also returns rows folded into the summary.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"subject_type": "<subject_type>",
"subject_id": "<subject_id>"
},
"name": "ai_conversation_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional. Only applies when listing. Max conversations to return. Default 50, max 200. | |
| project_id | Yes | Project ID (UUID), subdomain, or slug — resolved server-side, no UUID lookup needed. 'default' also works when the account has exactly one project; multi-project accounts must name one (the error lists them). | |
| subject_id | Yes | Conversation owner id. The server applies this scope to both list and single-conversation reads. | |
| subject_type | Yes | Conversation owner type. 'app_user' is for signed-in app users. | |
| conversation_id | No | Optional. A saved record id returned by ai_conversation_list fetches that conversation with its messages. Omitted: all conversations are listed. | |
| include_summarized | No | Optional. Only applies when fetching one conversation: when true, also returns messages folded into the summary (the full transcript). Default false. |