agentsMessages

Search Messages

Search messages across the entire organization with optional project and template filtering. Returns messages with FTS/vector ranks and total RRF score.

This is a cloud-only feature.

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Request

This endpoint expects an object.
querystring or nullOptional

Text query for full-text search

search_modeenumOptionalDefaults to hybrid
Search mode to use
Allowed values:
roleslist of enums or nullOptional
Filter messages by role
project_idstring or nullOptional
Filter messages by project ID
template_idstring or nullOptional
Filter messages by template ID
limitintegerOptional>=1<=100Defaults to 50
Maximum number of results to return
start_datestring or nullOptionalformat: "date-time"
Filter messages created after this date
end_datestring or nullOptionalformat: "date-time"
Filter messages created on or before this date

Response

Successful Response
embedded_textstring

The embedded content (LLM-friendly)

messageobject
The raw message object
rrf_scoredouble
Reciprocal Rank Fusion combined score
fts_rankinteger or null

Full-text search rank position if FTS was used

vector_rankinteger or null
Vector search rank position if vector search was used

Errors