Conversations - InboxMate

list_conversations

List conversations with optional filters and pagination. Parameters:

string

Filter conversations by agent ID.

string

Search within message content.

number

Max results to return. Defaults to 20, max 50.

number

Pagination offset. Defaults to 0.

Example request:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_conversations",
    "arguments": {
      "agentId": "abc-123",
      "limit": 10
    }
  },
  "id": 1
}

Example response:

{
  "conversations": [
    {
      "id": "conv-456",
      "agentId": "abc-123",
      "status": "resolved",
      "messagePreview": "How do I reset my password?",
      "messageCount": 6,
      "createdAt": "2025-02-01T09:15:00Z",
      "updatedAt": "2025-02-01T09:22:00Z"
    }
  ],
  "total": 42
}

get_conversation

Get a single conversation with its full message history. Parameters:

string

required

The ID of the conversation to retrieve.

Example request:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_conversation",
    "arguments": {
      "conversationId": "conv-456"
    }
  },
  "id": 2
}

Example response:

{
  "id": "conv-456",
  "agentId": "abc-123",
  "status": "resolved",
  "createdAt": "2025-02-01T09:15:00Z",
  "messages": [
    {
      "id": "msg-1",
      "role": "user",
      "content": "How do I reset my password?",
      "createdAt": "2025-02-01T09:15:00Z"
    },
    {
      "id": "msg-2",
      "role": "assistant",
      "content": "You can reset your password by clicking...",
      "createdAt": "2025-02-01T09:15:02Z"
    }
  ]
}

​list_conversations

​get_conversation

list_conversations

get_conversation