list_conversations
Retrieve and filter conversations by status, priority, category, or search terms to manage user feedback and support requests effectively.
Instructions
List conversations with optional filters. Returns conversations with status, priority, unread counts, and pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Filter by status: open, in_progress, waiting_user, waiting_admin, resolved, closed | |
| priority | No | Filter by priority: low, normal, high, urgent | |
| app_id | No | Filter by app ID | |
| search | No | Search in conversation titles and messages | |
| category | No | Filter by category: bug, feature, question, feedback, other | |
| assigned_to | No | Filter by assigned admin ID | |
| limit | No | Max results (default: 50) | |
| offset | No | Pagination offset (default: 0) | |
| sort | No | Sort by: last_message, created, updated (default: last_message) |
Implementation Reference
- index.js:404-417 (handler)Handler logic for 'list_conversations' tool, which constructs query parameters and performs a GET request to the Cuti-E API.
case "list_conversations": { const query = {}; if (args?.status) query.status = args.status; if (args?.priority) query.priority = args.priority; if (args?.app_id) query.app_id = args.app_id; if (args?.search) query.search = args.search; if (args?.category) query.category = args.category; if (args?.assigned_to) query.assigned_to = args.assigned_to; if (args?.limit) query.limit = args.limit; if (args?.offset) query.offset = args.offset; if (args?.sort) query.sort = args.sort; result = await apiRequest("GET", "/v1/conversations", { query }); break; } - index.js:84-129 (registration)Registration and schema definition for the 'list_conversations' tool.
{ name: "list_conversations", description: "List conversations with optional filters. Returns conversations with status, priority, unread counts, and pagination.", inputSchema: { type: "object", properties: { status: { type: "string", description: "Filter by status: open, in_progress, waiting_user, waiting_admin, resolved, closed", }, priority: { type: "string", description: "Filter by priority: low, normal, high, urgent", }, app_id: { type: "string", description: "Filter by app ID", }, search: { type: "string", description: "Search in conversation titles and messages", }, category: { type: "string", description: "Filter by category: bug, feature, question, feedback, other", }, assigned_to: { type: "string", description: "Filter by assigned admin ID", }, limit: { type: "number", description: "Max results (default: 50)", }, offset: { type: "number", description: "Pagination offset (default: 0)", }, sort: { type: "string", description: "Sort by: last_message, created, updated (default: last_message)", }, }, }, },