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