latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

List chats across all agency creators

Returns a single paginated stream of chats across every creator the authenticated agency manages, sorted by most recent activity. Each row is tagged with creatorUuid so consumers can group results by creator without an additional join.

Replaces the per-creator GET /creators/{uuid}/chats fan-out used by agency CRM sync flows: 1 + N calls collapse to ceil(total/size) calls.

Mute state is per-creator: isMuted is true only when the specific creator that owns the chat row has muted the counterpart, not when any other agency creator has. <Info>Requires: Agency admin access</Info>

get/agencies/chats

Query parameters

pageinteger

Page number to retrieve (starts from 1)

Page number to retrieve (starts from 1)

sizeinteger

Number of items to return per page (1-50, default: 15)

Number of items to return per page (1-50, default: 15)

updatedAfterstring date-time

Incremental sync: only return chats with activity strictly after this timestamp. Chats with no messages are excluded.

Incremental sync: only return chats with activity strictly after this timestamp. Chats with no messages are excluded.

sortBy'most_recent_messages' | 'online_now' | 'most_unanswered_chats'

Sort order for the chat list (default: most_recent_messages)

Sort order for the chat list (default: most_recent_messages)

sortDirection'asc' | 'desc'

Sort direction for the chat list (default: desc)

Sort direction for the chat list (default: desc)

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Paginated list of chats across the agency's creators