Skip to main content
GET
List conversations

Authorizations

Authorization
string
header
required

Bot token (wc_bot_live_… or wc_bot_test_…) from the OAuth install

Query Parameters

types
string

Comma-separated types to include: channel, private_channel. Both by default. Unknown types, including group, are ignored.

Example:

"channel,private_channel"

include_archived
boolean
default:false

Include archived groups and their channels

limit
integer
default:200

Page size, 200 by default. Values above 1000 are clamped.

Required range: x >= 1
cursor
string

The previous page's next_cursor. Omit it for the first page.

Response

A page of conversations

A page of conversations, oldest first.

conversations
PublicApiConversation · object[]
required
next_cursor
string | null
required

Pass as cursor for the next page; null on the last page

ok
enum<boolean>
required
Available options:
true