Returns a fact by UUID

Delete a fact for the given UUID

Add a session

Get all sessions with optional page number, page size, order by field and order direction for pagination.

Page number for pagination, starting from 1

Order direction: true for ascending, false for descending

Returns all sessions in a specified order

End multiple sessions

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

Search sessions for the specified query.

Returns a session by ID

Update a session

Classify a session

End a session

Returns all facts for a session by ID

Adds facts to a session

Returns a memory (latest summary, list of messages and facts for models.MemoryTypePerpetual) for a given session

The ID of the session for which to retrieve memory.

The number of most recent memory entries to retrieve.

The minimum rating by which to filter facts

Get session memory

The ID of the session to which memory should be added.

Add memory to the specified session.

The ID of the session for which memory should be deleted.

Delete memory messages for a given session

Lists messages for a session, specified by limit and cursor.

Lists messages for a session

Gets a specific message from a session

Updates the metadata of a message.

The ID of the session for which memory should be searched.

Search memory for the specified session.

Returns a session's summaries by ID

Synthesize a question from the last N messages in the chat history.

The number of messages to use for question synthesis.

Synthesize a question

Memory

Add a user.

List all users

Get a user.

Delete a user

Update a user.

List all sessions for a user

User

Returns a list of all DocumentCollections.

Gets a list of DocumentCollections

Returns a DocumentCollection if it exists.

Gets a DocumentCollection

If a collection with the same name already exists, an error will be returned.

Creates a new DocumentCollection

If a collection with the same name already exists, it will be overwritten.

Deletes a DocumentCollection

Updates a DocumentCollection

Creates Documents in a specified DocumentCollection and returns their UUIDs.

Creates Multiple Documents in a DocumentCollection

Deletes specified Documents from a DocumentCollection.

Batch Deletes Documents from a DocumentCollection by UUID

Returns Documents from a DocumentCollection specified by UUID or ID.

Batch Gets Documents from a DocumentCollection

Updates Documents in a specified DocumentCollection.

Batch Updates Documents in a DocumentCollection

Delete specified Document from a DocumentCollection.

Delete Document from a DocumentCollection by UUID

Searches over documents in a collection based on provided search criteria. One of text or metadata must be provided. Returns an empty list if no documents are found.

Searches Documents in a DocumentCollection

Document

APIError

AddedFact

ClassifySessionRequest

Custom instruction to use for classification.

The number of session messages to consider for classification. Defaults to 4.

The name of the classifier. Will be used to store the classification in session metadata if persist is True.

Whether to persist the classification to session metadata. Defaults to True.

ClassifySessionResponse

CreateDocumentRequest

DocumentCollectionResponse

DocumentResponse

DocumentSearchResult

DocumentSearchResultPage

EndSessionResponse

EndSessionsResponse

Fact

FactRatingExamples

FactRatingInstruction

Examples is a list of examples that demonstrate how facts might be rated based on your instruction. You should provide
an example of a highly rated example, a low rated example, and a medium (or in between example). For example, if you are rating
based on relevance to a trip planning application, your examples might be:
High: "Joe's dream vacation is Bali"
Medium: "Joe has a fear of flying",
Low: "Joe's favorite food is Japanese",

A string describing how to rate facts as they apply to your application. A trip planning application may
use something like "relevancy to planning a trip, the user's preferences when traveling,
or the user's travel history."

FactResponse

FactsResponse

A list of message objects, where each message contains a role and content.

A dictionary containing metadata associated with the memory.

Summary list result from Summary Retriever Memory Type.

MemorySearchResult

MemoryType

Message

The timestamp of when the message was created.

The metadata associated with the message.

The role of the sender of the message (e.g., "user", "assistant").

The type of the role (e.g., "user", "system").

The timestamp of when the message was last updated.

MessageListResponse

Question

RoleType

SearchScope

SearchType

Session

Must be a pointer to allow for null values

SessionListResponse

SessionSearchResponse

SessionSearchResult

SuccessResponse

Summary

The timestamp of when the summary was created.

1	{
2	"facts": [
3	"facts"
4	],
5	"messages": [
6	{
7	"content": "content",
8	"created_at": "created_at",
9	"role": "role",
10	"role_type": "norole",
11	"token_count": 1,
12	"updated_at": "updated_at",
13	"uuid": "uuid"
14	}
15	],
16	"metadata": {
17	"metadata": {
18	"key": "value"
19	}
20	},
21	"relevant_facts": [
22	{
23	"created_at": "created_at",
24	"fact": "fact",
25	"rating": 1.1,
26	"uuid": "uuid"
27	}
28	],
29	"relevant_summaries": [
30	{
31	"content": "content",
32	"created_at": "created_at",
33	"related_message_uuids": [
34	"related_message_uuids"
35	],
36	"token_count": 1,
37	"uuid": "uuid"
38	}
39	],
40	"summary": {
41	"content": "content",
42	"created_at": "created_at",
43	"metadata": {
44	"metadata": {
45	"key": "value"
46	}
47	},
48	"related_message_uuids": [
49	"related_message_uuids"
50	],
51	"token_count": 1,
52	"uuid": "uuid"
53	}
54	}

Get session memory

Path parameters

Query parameters

Response

Errors

1	curl https://api.getzep.com/api/v2/sessions/sessionId/memory \
2	-H "Authorization: Api-Key <apiKey>"