List Threads
List email threads for the current user with cursor-based pagination.
Supports virtual folders:
- inbox: Non-archived, non-draft threads
- sent: Outbound threads
- drafts: Draft messages
- starred: Starred threads
- archived: Archived threads
- all: All threads (includes system emails if user has read_all permission)
If include_all_system_emails is True and the user has the messaging:emails:read_all permission, all system emails will be included regardless of who sent them.
For the “all” folder, system emails are automatically included if the user has the permission.
Headers
The tenant you are making this request on behalf of
Your api key
Query Parameters
Virtual folder to filter by
INBOX, SENT, DRAFTS, STARRED, ARCHIVED, ALL 1 <= x <= 100Cursor for pagination
Search in subject and snippet
Include all system emails (requires messaging:emails:read_all permission)
Thread scope: provider for current-user threads, clinic for the shared tenant mailbox
provider, clinic Triage lens: unread OR awaiting-reply OR starred
Only unread threads
Only starred threads
Only threads linked to a patient
Only threads with an attachment
By-patient lens: section threads by linked patient (implies has_patient)
