Skip to main content
GET
Search conversations

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Query Parameters

q
string
required

Free-text query. Searches the full message transcript, not just titles.

limit
integer | null

Max hits to return (default 20, max 50).

Required range: x >= 0
cursor
string | null

Opaque forward-pagination cursor from a previous response.

channel_kind
string | null

Restrict to one channel: slack | teams | web | api | cli | email.

agent
string | null

Restrict to one agent (slug).

mode
string | null

Lane filter: fast (quick-ask threads) | standard | all (default all).

Response

200 - application/json

Ranked message-level search hits

hits
object[]
required
took_ms
integer<int64>
required
Required range: x >= 0
next_cursor
string | null

Pass back as cursor to fetch the next page; null when exhausted.