Skip to main content
GET
Search Messages

Headers

Authorization
string
required

Path Parameters

thread_id
string
required

Query Parameters

query
string
required

The text to search for within messages.

cursor
string | null

Base64-encoded pagination cursor. If not provided, retrieves the first batch of results.

limit
integer
default:20

Maximum number of search results to return per page.

context_size
integer
default:10

Number of messages to include before and after each match to provide conversation context.

Response

Successful Response

matches
SearchMatch · object[]
required

List of search matches with context.

pagination
CursorPagination · object
required