List threads

The chat's threads (one per conversation), newest first by default, each with its events (up to 1000).

Pages carry the first request's settings in page_id.

POST/v1/agent/action/list_threads

List threads

curl -X POST 'https://app.staging.mlive.chat/v1/agent/action/list_threads' \
  -H "Authorization: Bearer $MLC_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "chat_id": "01937c6e-0000-7000-8000-000000000001"
  }'

const res = await fetch('https://app.staging.mlive.chat/v1/agent/action/list_threads', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MLC_BOT_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "chat_id": "01937c6e-0000-7000-8000-000000000001"
  }),
});
const data = await res.json();

Response200

{
  "threads": [
    {
      "id": "828aec20-b9c3-7700-80fb-c1e028342cc0",
      "created_at": "2026-11-13T09:30:00Z",
      "active": true,
      "user_ids": [
        "749389f6-853a-76d0-85e2-43aaa689a084"
      ],
      "events": [
        {
          "id": "828aec20-b9c3-7700-80fb-c1e028342cc0",
          "created_at": "2026-11-13T07:57:41.512000Z",
          "type": "message",
          "text": "Orders ship within 1 business day.",
          "author_id": "19623f8a-8ab9-7d30-8c10-9ad66d67c87c",
          "visibility": "all",
          "system_message_type": "handover_requested",
          "name": "Nadia Rahman",
          "url": "https://hooks.northwind.example/mlivechat",
          "content_type": "application/pdf",
          "size": 1,
          "width": 1200,
          "height": 800,
          "properties": {}
        }
      ],
      "properties": {},
      "access": {
        "group_ids": [
          0
        ]
      },
      "previous_thread_id": "f81acd41-8943-73b8-8a6b-9a2fab9400a6",
      "next_thread_id": "a47a8181-e08c-71b8-8c9d-81ef58af0226"
    }
  ],
  "found_threads": 1,
  "next_page_id": "MjAyNi0xMS0xM1QwOTozMDowMFo",
  "previous_page_id": "316fbd3a-387f-73b0-8f8f-aa26469fa09c"
}

Specifics

Method URL	`POST https://app.staging.mlive.chat/v1/agent/action/list_threads`
Who can call it	Bots, with a bot token (`mlcb_`).

Request body

application/json

chat_idstringrequired
sort_orderstring
One of asc, desc. Default "desc".
limitinteger
1 to 100. Default 3.
page_idstring
From a previous answer; nothing else may be sent with it.

Response

200 · application/json

OK.

threadsarray of LCThreadrequired
found_threadsintegerrequired
next_page_idstring
previous_page_idstring

Errors

default