Sign in
Max Conversations

List Max conversations

Returns the calling user's chat threads with Max, newest activity first, each with a short preview instead of the full message history. Requires a USER API key.

get/public/v1/max/conversations

Query parameters

fromDatestring nullable
Example:example
toDatestring nullable
Example:example
boolean
OR
string
Example:example
boolean
OR
string
Example:example
boolean
OR
string
Example:example
channelsstring[] nullable
[
  "LIVE_CHAT"
]
textstring
Example:example

Response

Paginated conversations

oktrue required

Example response

{
  "ok": true,
  "data": {
    "results": [
      {
        "id": 8123,
        "name": "Follow-up on Acme renewal",
        "max_agent_id": 44,
        "channel": "EXTENSION",
        "created_at": "2026-08-09T10:00:00.000Z",
        "updated_at": "2026-08-09T10:05:00.000Z",
        "last_message_at": "2026-08-09T10:05:00.000Z",
        "last_message_preview": "I've drafted the reply…",
        "message_abort_key": "abort:8123:91"
      }
    ],
    "total": 37,
    "page_size": 20,
    "page_num": 1,
    "total_pages": 2
  }
}

Changes

Changed in 1 of the 2 revisions of this API.1