List chats

GET 
/chat.list

List accessible chats — DMs, multi-DMs, group chats, all-hands "team Roam" groups, and meeting chats.

Personal access tokens are backed by the user's inbox: chats are ordered by most recent activity and include lastMessageTime, isUnread, preview, isMuted, and isPinned. Bot threads (where the user has unread replies) are returned as separate rows keyed by threadTimestamp.

Organization tokens receive the chats the bot has access to, ordered by chat creation time. Inbox-derived fields (lastMessageTime, isUnread, preview, isMuted, isPinned) are not populated, since bot addresses do not accumulate inbox state for normal messages — those are delivered via webhooks.

Timestamps are returned in the caller's timezone (see Timezone handling).

Required scope: chat:read

Pass expand=addresses to include an address sidecar for chat participants and preview senders. See Identity & Principals.

---

OpenAPI Spec: chat-v1.json

Request

Responses

200

Chats retrieved successfully

400

Bad request. Common causes:

• limit is non-numeric, ≤ 0, or > 50
• cursor is not a valid micro-second timestamp

401

Presented invalid authentication credentials.

405

An unsupported method was requested.

500

An internal error occurred, including a preview sender that cannot resolve as a visible principal. The endpoint does not return a partial page.