Search Graph

POST

Perform a graph search query.

This endpoint expects an object.

querystringRequired

The string to search for (required)

center_node_uuidstringOptional

Node to rerank around for node distance reranking

group_idstringOptional

one of user_id or group_id must be provided

limitintegerOptional

The maximum number of facts to retrieve. Defaults to 10. Limited to 50.

min_scoredoubleOptional

minimum similarity score for a result to be returned

mmr_lambdadoubleOptional

weighting for maximal marginal relevance

rerankerenumOptional

Allowed values: rrfmmrnode_distanceepisode_mentionscross_encoder

Defaults to RRF

scope"edges" or "nodes"Optional

Allowed values: edgesnodes

Defaults to Edges. Communities will be added in the future.

user_idstringOptional

one of user_id or group_id must be provided

Graph search results

edgeslist of objectsOptional

nodeslist of objectsOptional

1	curl -X POST https://api.getzep.com/api/v2/graph/search \
2	-H "Content-Type: application/json" \
3	-d '{
4	"query": "query"
5	}'

1	{
2	"edges": [
3	{
4	"created_at": "created_at",
5	"fact": "fact",
6	"name": "name",
7	"source_node_uuid": "source_node_uuid",
8	"target_node_uuid": "target_node_uuid",
9	"uuid": "uuid",
10	"episodes": [
11	"episodes"
12	],
13	"expired_at": "expired_at",
14	"invalid_at": "invalid_at",
15	"valid_at": "valid_at"
16	}
17	],
18	"nodes": [
19	{
20	"created_at": "created_at",
21	"name": "name",
22	"summary": "summary",
23	"uuid": "uuid",
24	"labels": [
25	"labels"
26	]
27	}
28	]
29	}