Skip to main content
POST
Genai Search

Corps

application/json

Query the messages table by content and/or span-level filters.

Scans the messages table (one row per message occurrence, populated by an MV from spans) and returns matching span-level hits. Full-text search sets query; structured retrieval (e.g. all messages in a trace) leaves query empty and uses the filters below. The caller groups by conversation for the response shape.

project_id
string
requis
query
string
défaut:""
trace_id
string | null
roles
enum<string>[] | null
Options disponibles:
,
user,
assistant,
system,
tool,
tool_call,
tool_result
conversation_id
string | null
agent_name
string | null
provider_name
string | null
request_model
string | null
truncate_content
boolean
défaut:true
started_after
string<date-time> | null
started_before
string<date-time> | null
limit
integer
défaut:20
Plage requise: 0 <= x <= 1000
offset
integer
défaut:0
Plage requise: x >= 0

Réponse

Successful Response

Response from a full-text search across agent messages.

results
AgentSearchConversationResult · object[]
requis
total_conversations
integer
défaut:0
requis
Dernière modification le 30 septembre 2026