Skip to main content
List conversations

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

app_id
string
required

The unique identifier of the app.

Query Parameters

limit
integer
default:20

Maximum number of conversations to return. Range: 1-100.

after
string

A cursor for forward pagination. Returns conversations created after the conversation with this ID.

before
string

A cursor for backward pagination. Returns conversations created before the conversation with this ID.

order
string
default:desc

Sort order by creation time. Either 'asc' or 'desc'.

Response

OK

data
ConversationSchema · object[]
required

The array of conversation objects for the current page.

object
string
default:list

The object type. Always 'list'.

first_id
string | null

The ID of the first conversation in the returned page. Null if the list is empty.

last_id
string | null

The ID of the last conversation in the returned page. Null if the list is empty.

has_more
boolean
default:false

Whether there are additional conversations beyond this page. Use the 'after' or 'before' query parameters to paginate.