Skip to navigation
SDK Referencegraph

Search thread summaries

Authentication

AuthorizationApi-Key

Type "Api-Key" followed by a space and the project API key.

Path parameters

graph_uuidstringRequired
Graph UUID

Query parameters

limitintegerOptional
Page size
cursorstringOptional
Opaque page cursor

Request

Request body
querystringRequired
The search query.
bfs_origin_node_uuidslist of stringsOptional

Nodes used as BFS origins for graph-distance-aware retrieval.

center_node_uuidstringOptional

The node to rank results by distance from. Required when reranker is node_distance.

filtersobjectOptional
Filters constraining which items are returned.
mmr_lambdadoubleOptional
The diversity weighting used for maximal marginal relevance reranking. Required when reranker is mmr.
rerankerenumOptional
The reranking strategy applied to retrieved results. Defaults to rrf.
Allowed values:

Response

OK
itemslist of objectsOptional
The thread summaries on this page.
next_cursorstringOptional

The cursor to pass as the next request's cursor to fetch the following page; absent when no further pages remain.

total_sizeintegerOptional

Omitted for this collection; use next_cursor to detect the end of pagination.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error