For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
PlaygroundDiscordStatusDashboardSign Up >
DocumentationSDK ReferenceGraphiti
DocumentationSDK ReferenceGraphiti
  • SDK Reference
        • GETReturns a fact by UUID
        • DELDelete a fact for the given UUID
        • POSTEnd multiple sessions.
        • POSTSearch sessions for the specified query.
        • PATCHUpdate a session.
        • POSTDeprecated: Classify Session
        • POSTEnd a session
        • GETReturns all facts for a session by ID
        • POSTAdds facts to a session
        • GETGet Message
        • PATCHUpdates the metadata of a message.
        • POSTDeprecated: Use search_sessions method instead
        • GETReturns a session's summaries by ID
        • GETSynthesize a question
LogoLogo
PlaygroundDiscordStatusDashboardSign Up >
SDK ReferenceDeprecatedMemory

Search sessions for the specified query.

Deprecated
POST
https://api.getzep.com/api/v2/sessions/search
POST
/api/v2/sessions/search
$curl -X POST https://api.getzep.com/api/v2/sessions/search \
> -H "Authorization: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{
> "text": "string"
>}'
1{
2 "results": [
3 {
4 "fact": {
5 "content": "string",
6 "created_at": "string",
7 "fact": "string",
8 "uuid": "string",
9 "expired_at": "string",
10 "invalid_at": "string",
11 "name": "string",
12 "rating": 1.1,
13 "source_node_name": "string",
14 "target_node_name": "string",
15 "valid_at": "string"
16 },
17 "message": {
18 "content": "string",
19 "role_type": "norole",
20 "created_at": "string",
21 "metadata": {},
22 "processed": true,
23 "role": "string",
24 "token_count": 1,
25 "updated_at": "string",
26 "uuid": "string"
27 },
28 "score": 1.1,
29 "session_id": "string",
30 "summary": {
31 "content": "string",
32 "created_at": "string",
33 "metadata": {},
34 "related_message_uuids": [
35 "string"
36 ],
37 "token_count": 1,
38 "uuid": "string"
39 }
40 }
41 ]
42}

Deprecated API: Search sessions for the specified query.

Was this page helpful?
Previous

Update a session.

Next
Built with

Query parameters

limitintegerOptional

The maximum number of search results to return. Defaults to None (no limit).

Request

A SessionSearchQuery object representing the search query.
textstringRequired<=256 characters
The search text.
min_fact_ratingdoubleOptional
The minimum fact rating to filter on.
min_scoredoubleOptional
The minimum score for search results.
mmr_lambdadoubleOptional
The lambda parameter for the MMR Reranking Algorithm.
record_filtermap from strings to anyOptional
Record filter on the metadata.
search_scopeenumOptional
Search scope.
Allowed values:
search_typeenumOptional
Search type.
Allowed values:
session_idslist of stringsOptional
the session ids to search
user_idstringOptional
User ID used to determine which sessions to search.

Response

A SessionSearchResponse object representing the search results.
resultslist of objects

Errors

500
Internal Server Error