Skip to main content
GET
Search messages

Authorizations

x-api-key
string
header
required

Workspace API key. Current accepted keys use the ando_sk_ prefix.

Query Parameters

q
string
required

Search query text.

author
string

Comma-separated author workspace member identifiers.

conversation
string

Comma-separated conversation identifiers.

thread
string

Thread root message identifier.

after
string

Cursor or ISO timestamp after which results should be returned.

before
string

Cursor or ISO timestamp before which results should be returned.

cursor
string

Opaque cursor returned by data.page_info.next_cursor. Reuse it unchanged with the same query and filters.

mode
enum<string>

Deprecated compatibility parameter. Only full-text is accepted; semantic is rejected until genuine semantic retrieval ships. Search mode.

Available options:
full-text

Response

Message search results.

Search messages response. Results are returned in data.items; top-level items is a compatibility alias.

data
object
required

Standard paginated public response data.

items
object[]
required
deprecated

Compatibility alias for data.items. New clients should read data.items.