List threads
Chat & Messaging
List threads
Returns a paginated list of conversation threads for the authenticated user. Requires authentication.
GET
List threads
Authorizations
Session token (snat_…) minted by POST /v1/token. Carries the organization and the end user; safe in a browser.
Query Parameters
Page number (default 1)
Required range:
x >= 1Items per page (default 20, max 100)
Required range:
1 <= x <= 100Field to order by: createdAt or updatedAt (default updatedAt)
Available options:
createdAt, updatedAt Sort order: asc or desc (default desc)
Available options:
asc, desc Filter by specific thread ID
Example:
"thread_2f81c04a"
Only threads whose metadata.source matches — e.g. workflow for scheduled-workflow result threads.
Example:
"workflow"
true → only threads the user has not read yet (metadata.unread); false → only read ones.