agents

Search Messages

Changed on

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.

post/v1/agents/messages/search

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/agents/messages/search
  • Auth
    HTTP bearer

Request body

querystring nullable

Text query for full-text search

search_mode'vector' | 'fts' | 'hybrid'

Search mode to use

rolesMessageRole[] nullable

Filter messages by role

project_idstring nullable

Filter messages by project ID

template_idstring nullable

Filter messages by template ID

limitinteger

Maximum number of results to return

start_datestring date-time nullable

Filter messages created after this date

end_datestring date-time nullable

Filter messages created on or before this date

Response

Successful Response

embedded_textstring required

The embedded content (LLM-friendly)

fts_rankinteger nullable

Full-text search rank position if FTS was used

vector_rankinteger nullable

Vector search rank position if vector search was used

rrf_scorenumber required

Reciprocal Rank Fusion combined score

Example response

[
  {
    "message": {
      "id": "message-123e4567-e89b-12d3-a456-426614174000"
    }
  }
]

Changes

  • 42a9cd544e13Revision changes
    • info

      added the optional property ///// to the response with the status

  • 1ba60b114a27Revision changes
    • info

      added the optional property ///// to the response with the status