Conversations

List and manage chat conversations across your account.

GET

/v1/chat/conversations

Query Parameters

Parameter	Description
status	Filter by status: 'pending', 'active', 'closed'
assignment	Filter by assignment: 'mine', 'unassigned', or 'all'
tag	Filter by a single conversation tag
limit	Number of results per page (default: 50)

Response

JSON

{
  "success": true,
  "data": [
    {
      "id": "conv_abc123",
      "status": "active",
      "lastMessage": "Sure, I can help you with that.",
      "updatedAt": "2024-01-15T10:35:12Z",
      "agent": {
        "id": "agent_555",
        "name": "Sarah Miller"
      }
    }
  ],
  "pagination": {
    "total": 125,
    "nextCursor": "cXdlcnR5MTIz"
  }
}