Skip to main content
GET
List conversations

Authorizations

The full Cookie header copied from a signed-in connie.ai browser request. See the Authentication page.

Query Parameters

workspaceId
string<uuid>
required

Your workspace ID. Also accepted as workspace_id, the x-workspace-id header, or workspaceId in a JSON body. If you leave it out, the request silently runs against the first workspace you joined.

accountIds
string

Comma-separated account IDs (the account_id values on conversations). Defaults to every account you can access.

type
enum<string>

Restrict to email threads or to chats (WhatsApp, LinkedIn).

Available options:
email,
chat
folder
enum<string>

Mailbox folder. Archived conversations use showArchived instead.

Available options:
inbox,
sent,
spam,
drafts,
trash
unreadOnly
boolean
starredOnly
boolean
showArchived
boolean

Return only archived conversations.

conversationsOnly
boolean

Keep only email threads classified as real conversations (the "All conversations" view). Chats always pass.

Matches contact name, last-message preview and subject. Max 500 characters.

Maximum string length: 500
providers
string

Comma-separated platforms, for example GOOGLE_OAUTH,OUTLOOK,LINKEDIN,WHATSAPP.

tagName
string

Only conversations carrying this label name.

assigneeIds
string

Comma-separated user IDs the conversation is assigned to.

dateFrom
string<date-time>

Inclusive lower bound on the last message date (ISO 8601).

dateTo
string<date-time>

Inclusive upper bound on the last message date (ISO 8601).

conversationId
string<uuid>

Fetch one conversation by its id. Returns a one-item list, or an empty list if you can't access its account.

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string

The nextCursor from the previous page.

withCount
boolean

When true, total is the exact number of matching conversations instead of the page size.

Response

A page of conversations.

conversations
object[]
total
integer

Page size, or the exact match count when withCount=true.

hasMore
boolean
nextCursor
string | null
syncGated
boolean

True while a newly connected account is still doing its first sync.