List conversations

GET 
/conversation.list

Lists conversations (meetings) that occurred in your Roam, with participant details.

Access:

• Organization with admin:meetings:read (or a grandfathered roam-wide API key): all conversations in the workspace.
• Personal access tokens: supported — returns only conversations the token owner participated in (matched by confirmed email).
• Organization without roam-wide meeting access must use /meeting.list instead (403).

Required scope: meetings:read (add admin:meetings:read for roam-wide org access)

Participant details require user:read scope. Email addresses require user:read.email scope.

---

OpenAPI Spec: chat-v1.json

Request

Responses

200

Conversations retrieved successfully

400

Bad request.

401

Presented invalid authentication credentials.

403

Forbidden. Either a personal access token was used (an account-level token is required), or the org client does not have roam-wide meeting access (admin:meetings:read). Use /meeting.list instead.

500

An internal error occurred.