Skip to main content
GET
List threads

Authorizations

Authorization
string
header
required

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

Page number (default 1)

Required range: x >= 1
perPage
number
default:20

Items per page (default 20, max 100)

Required range: 1 <= x <= 100
orderBy
enum<string>
default:updatedAt

Field to order by: createdAt or updatedAt (default updatedAt)

Available options:
createdAt,
updatedAt
order
enum<string>
default:desc

Sort order: asc or desc (default desc)

Available options:
asc,
desc
threadId
string

Filter by specific thread ID

Example:

"thread_2f81c04a"

source
string

Only threads whose metadata.source matches — e.g. workflow for scheduled-workflow result threads.

Example:

"workflow"

unread
boolean

true → only threads the user has not read yet (metadata.unread); false → only read ones.

Response

Paginated list of threads

threads
object[]
page
number
perPage
number
total
number
hasMore
boolean