Skip to main content
GET
/
api
/
v2
/
conversations
/
views
List conversation views
curl --request GET \
  --url https://app.livechatai.com/api/v2/conversations/views \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "data": {
    "views": [
      {
        "id": "clx1234567890viewid",
        "name": "High Priority Negative",
        "query": {
          "combinator": "AND",
          "rules": [
            {
              "field": "sentiment",
              "operator": "EQUALS",
              "value": "NEGATIVE"
            }
          ]
        },
        "createdAt": "2024-01-15T10:30:00.000Z"
      }
    ],
    "meta": {
      "total": 10,
      "perPage": 20,
      "currentPage": 1,
      "totalPages": 1
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

agentId
string
required

Unique identifier of the agent/chatbot

Example:

"clx1234567890abcdef"

page
integer

Page number for pagination (default: 1)

Required range: x >= 1
Example:

1

perPage
integer

Number of inbox views per page (default: 20, max: 100)

Required range: 1 <= x <= 100
Example:

20

Search inbox views by name

Example:

"billing"

Response

Successfully retrieved inbox views list

status
string
Example:

"success"

data
object