{"openapi":"3.1.0","info":{"title":"SDK Reference","version":"1.0.0"},"paths":{"/sessions":{"post":{"operationId":"memory_add_session","summary":"Add Session","description":"Creates a new session.","tags":["memory"],"responses":{"201":{"description":"The added session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Session"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CreateSessionRequest"}}}}}},"/sessions/{sessionId}":{"get":{"operationId":"memory_get_session","summary":"Get Session.","description":"Returns a session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The unique identifier of the session.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The session with the specified ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Session"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"patch":{"operationId":"memory_update_session","summary":"Update a session.","description":"Update Session Metadata.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The unique identifier of the session.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The updated session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Session"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Session","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateSessionRequest"}}}}}},"/sessions-ordered":{"get":{"operationId":"memory_list_sessions","summary":"Get Sessions","description":"Returns all sessions.","tags":["memory"],"parameters":[{"name":"page_number","in":"query","description":"Page number for pagination, starting from 1","required":false,"schema":{"type":"integer"}},{"name":"page_size","in":"query","description":"Number of sessions to retrieve per page.","required":false,"schema":{"type":"integer"}},{"name":"order_by","in":"query","description":"Field to order the results by: created_at, updated_at, user_id, session_id.","required":false,"schema":{"type":"string"}},{"name":"asc","in":"query","description":"Order direction: true for ascending, false for descending.","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"List of sessions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SessionListResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/sessions/{sessionId}/memory":{"get":{"operationId":"memory_get","summary":"Get Session Memory","description":"Returns a memory for a given session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The ID of the session for which to retrieve memory.","required":true,"schema":{"type":"string"}},{"name":"lastn","in":"query","description":"The number of most recent memory entries to retrieve.","required":false,"schema":{"type":"integer"}},{"name":"minRating","in":"query","description":"The minimum rating by which to filter relevant facts.","required":false,"schema":{"type":"number","format":"double"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Memory"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"post":{"operationId":"memory_add","summary":"Add Memory to Session","description":"Add memory to the specified session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The ID of the session to which memory should be added.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"An object, optionally containing memory context retrieved for the last message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.AddMemoryResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"A Memory object representing the memory messages to be added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.AddMemoryRequest"}}}}},"delete":{"operationId":"memory_delete","summary":"Delete Session","description":"Deletes a session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The ID of the session for which memory should be deleted.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/sessions/{sessionId}/messages":{"get":{"operationId":"memory_get_session_messages","summary":"Get Messages for Session","description":"Returns messages for a session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Limit the number of results returned","required":false,"schema":{"type":"integer"}},{"name":"cursor","in":"query","description":"Cursor for pagination","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.MessageListResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/users":{"post":{"operationId":"user_add","summary":"Add User","description":"Adds a user.","tags":["user"],"responses":{"201":{"description":"The user that was added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.User"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"The user to add.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.CreateUserRequest"}}}}}},"/users-ordered":{"get":{"operationId":"user_listOrdered","summary":"Get Users","description":"Returns all users.","tags":["user"],"parameters":[{"name":"pageNumber","in":"query","description":"Page number for pagination, starting from 1","required":false,"schema":{"type":"integer"}},{"name":"pageSize","in":"query","description":"Number of users to retrieve per page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successfully retrieved list of users","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.UserListResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/users/{userId}":{"get":{"operationId":"user_get","summary":"Get User","description":"Returns a user.","tags":["user"],"parameters":[{"name":"userId","in":"path","description":"The user_id of the user to get.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The user that was retrieved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.User"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"delete":{"operationId":"user_delete","summary":"Delete User","description":"Deletes a user.","tags":["user"],"parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"patch":{"operationId":"user_update","summary":"Update User","description":"Updates a user.","tags":["user"],"parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The user that was updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.User"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Update User Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.UpdateUserRequest"}}}}}},"/users/{userId}/node":{"get":{"operationId":"user_getUserNode","summary":"Get User Node","description":"Returns a user's node.","tags":["user"],"parameters":[{"name":"userId","in":"path","description":"The user_id of the user to get the node for.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Response object containing the User node.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.UserNodeResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/users/{userId}/sessions":{"get":{"operationId":"user_get_sessions","summary":"Get User Sessions","description":"Returns all sessions for a user.","tags":["user"],"parameters":[{"name":"userId","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Session"}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/groups":{"post":{"operationId":"group_createGroup","summary":"Create Group","description":"Creates a new group.","tags":["group"],"responses":{"201":{"description":"The added group","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Group"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Group","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.CreateGroupRequest"}}}}}},"/groups-ordered":{"get":{"operationId":"group_getAllGroups","summary":"Get All Groups","description":"Returns all groups.","tags":["group"],"parameters":[{"name":"pageNumber","in":"query","description":"Page number for pagination, starting from 1.","required":false,"schema":{"type":"integer"}},{"name":"pageSize","in":"query","description":"Number of groups to retrieve per page.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successfully retrieved list of groups.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GroupListResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/groups/{groupId}":{"get":{"operationId":"group_getGroup","summary":"Get Group","description":"Returns a group.","tags":["group"],"parameters":[{"name":"groupId","in":"path","description":"The group_id of the group to get.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The group that was retrieved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Group"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"delete":{"operationId":"group_deleteGroup","summary":"Delete Group","description":"Deletes a group.","tags":["group"],"parameters":[{"name":"groupId","in":"path","description":"Group ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"patch":{"operationId":"group_updateGroup","summary":"Update Group","description":"Updates information about a group.","tags":["group"],"parameters":[{"name":"groupId","in":"path","description":"Group ID","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"The added group","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Group"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Group","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.UpdateGroupRequest"}}}}}},"/entity-types":{"get":{"operationId":"entity_getEntityTypes","summary":"Get Entity Types","description":"Returns all entity types for a project.","tags":["entity"],"responses":{"200":{"description":"The list of entity types.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.EntityTypeResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"put":{"operationId":"entity_setEntityTypes","summary":"Set Entity Types","description":"Sets the entity types for a project, replacing any existing ones.","tags":["entity"],"responses":{"200":{"description":"Entity types set successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"The entity types to set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.EntityTypeRequest"}}}}}},"/graph":{"post":{"operationId":"data_addData","summary":"Add Data","description":"Add data to the graph.","tags":["data"],"responses":{"202":{"description":"Added episode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEpisode"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Add data request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.AddDataRequest"}}}}}},"/graph-batch":{"post":{"operationId":"data_addDataInBatchMode","summary":"Add Data in batch mode","description":"Add data to the graph in batch mode, processing episodes concurrently. Use only for data that is insensitive to processing order.","tags":["data"],"responses":{"202":{"description":"Added episodes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/apidata.GraphEpisode"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Add data request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.AddDataBatchRequest"}}}}}},"/graph/add-fact-triple":{"post":{"operationId":"entity_addFactTriple","summary":"Add Fact Triple","description":"Add a fact triple for a user or group","tags":["entity"],"responses":{"200":{"description":"Resulting triple","content":{"application/json":{"schema":{"$ref":"#/components/schemas/graphiti.AddTripleResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Triple to add","content":{"application/json":{"schema":{"$ref":"#/components/schemas/graphiti.AddTripleRequest"}}}}}},"/graph/clone":{"post":{"operationId":"data_cloneGraph","summary":"Clone graph","description":"Clone a user or group graph.","tags":["data"],"responses":{"202":{"description":"Response object containing group_id or user_id pointing to the new graph","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.CloneGraphResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Clone graph request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.CloneGraphRequest"}}}}}},"/graph/search":{"post":{"operationId":"search_graph","summary":"Search Graph","description":"Perform a graph search query.","tags":["search"],"responses":{"200":{"description":"Graph search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphSearchResults"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Graph search query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/graphiti.GraphSearchQuery"}}}}}},"/graph/edge/group/{group_id}":{"post":{"operationId":"entity_getGroupEdges","summary":"Get Group Edges","description":"Returns all edges for a group.","tags":["entity"],"parameters":[{"name":"group_id","in":"path","description":"Group ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Edges","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityEdge"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Pagination parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEdgesRequest"}}}}}},"/graph/edge/user/{user_id}":{"post":{"operationId":"entity_getUserEdges","summary":"Get User Edges","description":"Returns all edges for a user.","tags":["entity"],"parameters":[{"name":"user_id","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Edges","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityEdge"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Pagination parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEdgesRequest"}}}}}},"/graph/edge/{uuid}":{"get":{"operationId":"entity_getEdge","summary":"Get Edge","description":"Returns a specific edge by its UUID.","tags":["entity"],"parameters":[{"name":"uuid","in":"path","description":"Edge UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Edge","content":{"application/json":{"schema":{"$ref":"#/components/schemas/graphiti.EntityEdge"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"delete":{"operationId":"entity_deleteEdge","summary":"Delete Edge","description":"Deletes an edge by UUID.","tags":["entity"],"parameters":[{"name":"uuid","in":"path","description":"Edge UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Edge deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/episodes/group/{group_id}":{"get":{"operationId":"episodes_getGroupEpisodes","summary":"Get Group Episodes","description":"Returns episodes by group id.","tags":["episodes"],"parameters":[{"name":"group_id","in":"path","description":"Group ID","required":true,"schema":{"type":"string"}},{"name":"lastn","in":"query","description":"The number of most recent episodes to retrieve.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Episodes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEpisodeResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/episodes/user/{user_id}":{"get":{"operationId":"episodes_getUserEpisodes","summary":"Get User Episodes","description":"Returns episodes by user id.","tags":["episodes"],"parameters":[{"name":"user_id","in":"path","description":"User ID","required":true,"schema":{"type":"string"}},{"name":"lastn","in":"query","description":"The number of most recent episodes entries to retrieve.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Episodes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEpisodeResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/episodes/{uuid}":{"get":{"operationId":"episodes_getEpisode","summary":"Get Episode","description":"Returns episodes by UUID","tags":["episodes"],"parameters":[{"name":"uuid","in":"path","description":"Episode UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Episode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEpisode"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}},"delete":{"operationId":"entity_deleteEpisode","summary":"Delete Episode","description":"Deletes an episode by its UUID.","tags":["entity"],"parameters":[{"name":"uuid","in":"path","description":"Episode UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Episode deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/episodes/{uuid}/mentions":{"get":{"operationId":"episodes_returnAnyNodesAndEdgesMentionedInAnEpisode","summary":"Return any nodes and edges mentioned in an episode","description":"Returns nodes and edges mentioned in an episode","tags":["episodes"],"parameters":[{"name":"uuid","in":"path","description":"Episode uuid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Edges and nodes mentioned in an episode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.EpisodeMentions"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/node/group/{group_id}":{"post":{"operationId":"entity_getGroupNodes","summary":"Get Group Nodes","description":"Returns all nodes for a group.","tags":["entity"],"parameters":[{"name":"group_id","in":"path","description":"Group ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Nodes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityNode"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Pagination parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphNodesRequest"}}}}}},"/graph/node/user/{user_id}":{"post":{"operationId":"entity_getUserNodes","summary":"Get User Nodes","description":"Returns all nodes for a user","tags":["entity"],"parameters":[{"name":"user_id","in":"path","description":"User ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Nodes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityNode"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"requestBody":{"description":"Pagination parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphNodesRequest"}}}}}},"/graph/node/{node_uuid}/entity-edges":{"get":{"operationId":"entity_getEntityEdgesForANode","summary":"Get Entity Edges for a node","description":"Returns all edges for a node","tags":["entity"],"parameters":[{"name":"node_uuid","in":"path","description":"Node UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Edges","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityEdge"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/node/{node_uuid}/episodes":{"get":{"operationId":"entity_getEpisodesForANode","summary":"Get Episodes for a node","description":"Returns all episodes that mentioned a given node","tags":["entity"],"parameters":[{"name":"node_uuid","in":"path","description":"Node UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Episodes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.GraphEpisodeResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/graph/node/{uuid}":{"get":{"operationId":"entity_getNode","summary":"Get Node","description":"Returns a specific node by its UUID.","tags":["entity"],"parameters":[{"name":"uuid","in":"path","description":"Node UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Node","content":{"application/json":{"schema":{"$ref":"#/components/schemas/graphiti.EntityNode"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}}}},"/facts/{factUUID}":{"get":{"operationId":"memory_get_fact","summary":"Returns a fact by UUID","description":"Deprecated API: get fact by uuid","tags":["memory"],"parameters":[{"name":"factUUID","in":"path","description":"Fact UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The fact with the specified UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.FactResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"delete":{"operationId":"memory_delete_fact","summary":"Delete a fact for the given UUID","description":"Deprecated API: delete a fact","tags":["memory"],"parameters":[{"name":"factUUID","in":"path","description":"Fact UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true}},"/sessions/end":{"post":{"operationId":"memory_end_sessions","summary":"End multiple sessions.","description":"Deprecated API: End multiple sessions by their IDs.","tags":["memory"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.EndSessionsResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"End Sessions Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.EndSessionsRequest"}}}}}},"/sessions/search":{"post":{"operationId":"memory_search_sessions","summary":"Search sessions for the specified query.","description":"Deprecated API: Search sessions for the specified query.","tags":["memory"],"parameters":[{"name":"limit","in":"query","description":"The maximum number of search results to return. Defaults to None (no limit).","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A SessionSearchResponse object representing the search results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SessionSearchResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"A SessionSearchQuery object representing the search query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.SessionSearchQuery"}}}}}},"/sessions/{sessionId}/classify":{"post":{"operationId":"memory_classify_session","summary":"Deprecated: Classify Session","description":"Deprecated: Classifies a session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A response object containing the name and classification result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SessionClassification"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Classify request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ClassifySessionRequest"}}}}}},"/sessions/{sessionId}/end":{"post":{"operationId":"memory_end_session","summary":"End a session","description":"Deprecated API: End a session by ID.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.EndSessionResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"End Session Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.EndSessionRequest"}}}}}},"/sessions/{sessionId}/facts":{"get":{"operationId":"memory_get_session_facts","summary":"Returns all facts for a session by ID","description":"Deprecated API: get facts for a session","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}},{"name":"minRating","in":"query","description":"Minimum rating by which to filter facts","required":false,"schema":{"type":"number","format":"double"}}],"responses":{"200":{"description":"The facts for the session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.FactsResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"post":{"operationId":"memory_add_session_facts","summary":"Adds facts to a session","description":"Deprecated API: Adds facts to a session","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Request body with a list of facts to add.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.AddFactsRequest"}}}}}},"/sessions/{sessionId}/messages/{messageUUID}":{"get":{"operationId":"memory_get_session_message","summary":"Get Message","description":"Deprecated: Use graph.episodes.get instead. Returns a specific message from a session.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Soon to be deprecated as this is not needed.","required":true,"schema":{"type":"string"}},{"name":"messageUUID","in":"path","description":"The UUID of the message.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Message"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"patch":{"operationId":"memory_update_message_metadata","summary":"Updates the metadata of a message.","description":"Updates the metadata of a message.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The ID of the session.","required":true,"schema":{"type":"string"}},{"name":"messageUUID","in":"path","description":"The UUID of the message.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The updated message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Message"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"The metadata to update.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.MessageMetadataUpdate"}}}}}},"/sessions/{sessionId}/search":{"post":{"operationId":"memory_search","summary":"Deprecated: Use search_sessions method instead","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The ID of the session for which memory should be searched.","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"The maximum number of search results to return. Defaults to None (no limit).","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"A list of SearchResult objects representing the search results.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/apidata.MemorySearchResult"}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"A SearchPayload object representing the search query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.MemorySearchPayload"}}}}}},"/sessions/{sessionId}/summary":{"get":{"operationId":"memory_getSummaries","summary":"Returns a session's summaries by ID","description":"Deprecated API: Get session summaries by ID","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"Session ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SummaryListResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true}},"/sessions/{sessionId}/synthesize_question":{"get":{"operationId":"memory_synthesizeQuestion","summary":"Synthesize a question","description":"Deprecated API: Synthesize a question from the last N messages in the chat history.","tags":["memory"],"parameters":[{"name":"sessionId","in":"path","description":"The ID of the session.","required":true,"schema":{"type":"string"}},{"name":"lastNMessages","in":"query","description":"The number of messages to use for question synthesis.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"The synthesized question.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Question"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true}},"/users/{userId}/facts":{"get":{"operationId":"user_getUserFacts","summary":"Get user facts.","description":"Deprecated: Use Get User Edges instead.","tags":["user"],"parameters":[{"name":"userId","in":"path","description":"The user_id of the user to get.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The user facts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.FactsResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true}},"/groups/{groupId}/facts":{"get":{"operationId":"group_getGroupFacts","summary":"Get Group Facts","description":"Deprecated: Use Get Group Edges instead.","tags":["group"],"parameters":[{"name":"groupId","in":"path","description":"The group_id of the group to get.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The group facts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.FactsResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true}},"/collections":{"get":{"operationId":"document_list_collections","summary":"Gets a list of DocumentCollections","description":"Returns a list of all DocumentCollections.","tags":["document"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/apidata.DocumentCollection"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true}},"/collections/{collectionName}":{"get":{"operationId":"document_get_collection","summary":"Gets a DocumentCollection","description":"Returns a DocumentCollection if it exists.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.DocumentCollection"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"post":{"operationId":"document_add_collection","summary":"Creates a new DocumentCollection","description":"If a collection with the same name already exists, an error will be returned.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Document Collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CreateDocumentCollectionRequest"}}}}},"delete":{"operationId":"document_delete_collection","summary":"Deletes a DocumentCollection","description":"If a collection with the same name already exists, it will be overwritten.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"patch":{"operationId":"document_update_collection","summary":"Updates a DocumentCollection","description":"Updates a DocumentCollection","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Document Collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateDocumentCollectionRequest"}}}}}},"/collections/{collectionName}/documents":{"post":{"operationId":"document_add_documents","summary":"Creates Multiple Documents in a DocumentCollection","description":"Creates Documents in a specified DocumentCollection and returns their UUIDs.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"type":"string"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Array of Documents to be created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.CreateDocumentRequest"}}}}}}},"/collections/{collectionName}/documents/batchDelete":{"post":{"operationId":"document_batchDeleteDocuments","summary":"Batch Deletes Documents from a DocumentCollection by UUID","description":"Deletes specified Documents from a DocumentCollection.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"UUIDs of the Documents to be deleted","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}}}},"/collections/{collectionName}/documents/batchGet":{"post":{"operationId":"document_batchGetDocuments","summary":"Batch Gets Documents from a DocumentCollection","description":"Returns Documents from a DocumentCollection specified by UUID or ID.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Document"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"UUIDs and IDs of the Documents to be fetched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.GetDocumentListRequest"}}}}}},"/collections/{collectionName}/documents/batchUpdate":{"patch":{"operationId":"document_batchUpdateDocuments","summary":"Batch Updates Documents in a DocumentCollection","description":"Updates Documents in a specified DocumentCollection.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Array of Documents to be updated","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.UpdateDocumentListRequest"}}}}}}},"/collections/{collectionName}/documents/uuid/{documentUUID}":{"get":{"operationId":"document_getsADocumentFromADocumentCollectionByUuid","summary":"Gets a Document from a DocumentCollection by UUID","description":"Returns specified Document from a DocumentCollection.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"documentUUID","in":"path","description":"UUID of the Document to be updated","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.Document"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"delete":{"operationId":"document_delete_document","summary":"Delete Document from a DocumentCollection by UUID","description":"Delete specified Document from a DocumentCollection.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"documentUUID","in":"path","description":"UUID of the Document to be deleted","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Document Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true},"patch":{"operationId":"document_updatesADocument","summary":"Updates a Document","description":"Updates a Document in a DocumentCollection by UUID","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"documentUUID","in":"path","description":"UUID of the Document to be updated","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.SuccessResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Document to be updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.UpdateDocumentRequest"}}}}}},"/collections/{collectionName}/search":{"post":{"operationId":"document_search","summary":"Searches Documents in a DocumentCollection","description":"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.","tags":["document"],"parameters":[{"name":"collectionName","in":"path","description":"Name of the Document Collection","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Limit the number of returned documents","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.DocumentSearchResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/apidata.APIError"}}}}},"deprecated":true,"requestBody":{"description":"Search criteria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.DocumentSearchPayload"}}}}}}},"tags":[{"name":"memory"},{"name":"user"},{"name":"group"},{"name":"entity"},{"name":"data"},{"name":"search"},{"name":"episodes"},{"name":"document"}],"servers":[{"url":"https://api.getzep.com/api/v2","description":"https://api.getzep.com/api/v2"}],"components":{"schemas":{"models.FactRatingExamples":{"type":"object","properties":{"high":{"type":"string"},"low":{"type":"string"},"medium":{"type":"string"}},"title":"models.FactRatingExamples"},"models.FactRatingInstruction":{"type":"object","properties":{"examples":{"$ref":"#/components/schemas/models.FactRatingExamples","description":"Examples is a list of examples that demonstrate how facts might be rated based on your instruction. You should provide\nan example of a highly rated example, a low rated example, and a medium (or in between example). For example, if you are rating\nbased on relevance to a trip planning application, your examples might be:\nHigh: \"Joe's dream vacation is Bali\"\nMedium: \"Joe has a fear of flying\",\nLow: \"Joe's favorite food is Japanese\","},"instruction":{"type":"string","description":"A string describing how to rate facts as they apply to your application. A trip planning application may\nuse something like \"relevancy to planning a trip, the user's preferences when traveling,\nor the user's travel history.\""}},"title":"models.FactRatingInstruction"},"models.CreateSessionRequest":{"type":"object","properties":{"fact_rating_instruction":{"$ref":"#/components/schemas/models.FactRatingInstruction","description":"Deprecated"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Deprecated"},"session_id":{"type":"string","description":"The unique identifier of the session."},"user_id":{"type":"string","description":"The unique identifier of the user associated with the session"}},"required":["session_id","user_id"],"title":"models.CreateSessionRequest"},"apidata.FactRatingExamples":{"type":"object","properties":{"high":{"type":"string"},"low":{"type":"string"},"medium":{"type":"string"}},"title":"apidata.FactRatingExamples"},"apidata.FactRatingInstruction":{"type":"object","properties":{"examples":{"$ref":"#/components/schemas/apidata.FactRatingExamples","description":"Examples is a list of examples that demonstrate how facts might be rated based on your instruction. You should provide\nan example of a highly rated example, a low rated example, and a medium (or in between example). For example, if you are rating\nbased on relevance to a trip planning application, your examples might be:\nHigh: \"Joe's dream vacation is Bali\"\nMedium: \"Joe has a fear of flying\",\nLow: \"Joe's favorite food is Japanese\","},"instruction":{"type":"string","description":"A string describing how to rate facts as they apply to your application. A trip planning application may\nuse something like \"relevancy to planning a trip, the user's preferences when traveling,\nor the user's travel history.\""}},"title":"apidata.FactRatingInstruction"},"apidata.Session":{"type":"object","properties":{"classifications":{"type":"object","additionalProperties":{"type":"string"}},"created_at":{"type":"string"},"deleted_at":{"type":"string"},"ended_at":{"type":"string"},"fact_rating_instruction":{"$ref":"#/components/schemas/apidata.FactRatingInstruction","description":"Deprecated"},"facts":{"type":"array","items":{"type":"string"},"description":"Deprecated"},"id":{"type":"integer"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Deprecated"},"project_uuid":{"type":"string"},"session_id":{"type":"string"},"updated_at":{"type":"string","description":"Deprecated"},"user_id":{"type":"string"},"uuid":{"type":"string"}},"title":"apidata.Session"},"apidata.APIError":{"type":"object","properties":{"message":{"type":"string"}},"title":"apidata.APIError"},"apidata.SessionListResponse":{"type":"object","properties":{"response_count":{"type":"integer"},"sessions":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Session"}},"total_count":{"type":"integer"}},"title":"apidata.SessionListResponse"},"apidata.RoleType":{"type":"string","enum":["norole","system","assistant","user","function","tool"],"title":"apidata.RoleType"},"apidata.Message":{"type":"object","properties":{"content":{"type":"string","description":"The content of the message."},"created_at":{"type":"string","description":"The timestamp of when the message was created."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"The metadata associated with the message."},"processed":{"type":"boolean","description":"Whether the message has been processed."},"role":{"type":"string","description":"Customizable role of the sender of the message (e.g., \"john\", \"sales_agent\")."},"role_type":{"$ref":"#/components/schemas/apidata.RoleType","description":"The type of the role (e.g., \"user\", \"system\")."},"token_count":{"type":"integer","description":"Deprecated"},"updated_at":{"type":"string","description":"Deprecated"},"uuid":{"type":"string","description":"The unique identifier of the message."}},"required":["content","role_type"],"title":"apidata.Message"},"apidata.Fact":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"expired_at":{"type":"string"},"fact":{"type":"string","description":"Deprecated"},"invalid_at":{"type":"string"},"name":{"type":"string"},"rating":{"type":"number","format":"double"},"source_node_name":{"type":"string"},"target_node_name":{"type":"string"},"uuid":{"type":"string"},"valid_at":{"type":"string"}},"required":["content","created_at","fact","uuid"],"title":"apidata.Fact"},"apidata.Summary":{"type":"object","properties":{"content":{"type":"string","description":"The content of the summary."},"created_at":{"type":"string","description":"The timestamp of when the summary was created."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"related_message_uuids":{"type":"array","items":{"type":"string"}},"token_count":{"type":"integer","description":"The number of tokens in the summary."},"uuid":{"type":"string","description":"The unique identifier of the summary."}},"title":"apidata.Summary"},"apidata.Memory":{"type":"object","properties":{"context":{"type":"string","description":"Memory context containing relevant facts and entities for the session. Can be put into the prompt directly."},"facts":{"type":"array","items":{"type":"string"},"description":"Deprecated: Use relevant_facts instead."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Message"},"description":"A list of message objects, where each message contains a role and content. Only last_n messages will be returned"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Deprecated"},"relevant_facts":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Fact"},"description":"Most relevant facts to the recent messages in the session."},"summary":{"$ref":"#/components/schemas/apidata.Summary","description":"Deprecated: Use context string instead."}},"title":"apidata.Memory"},"apidata.MessageListResponse":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Message"},"description":"A list of message objects."},"row_count":{"type":"integer","description":"The number of messages returned."},"total_count":{"type":"integer","description":"The total number of messages."}},"title":"apidata.MessageListResponse"},"apidata.AddMemoryRequest":{"type":"object","properties":{"fact_instruction":{"type":"string","description":"Deprecated"},"ignore_roles":{"type":"array","items":{"$ref":"#/components/schemas/apidata.RoleType"},"description":"Optional list of role types to ignore when adding messages to graph memory.\nThe message itself will still be added, retained and used as context for messages\nthat are added to a user's graph."},"messages":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Message"},"description":"A list of message objects, where each message contains a role and content."},"return_context":{"type":"boolean","description":"Optionally return memory context relevant to the most recent messages."},"summary_instruction":{"type":"string","description":"Deprecated"}},"required":["messages"],"title":"apidata.AddMemoryRequest"},"apidata.AddMemoryResponse":{"type":"object","properties":{"context":{"type":"string"}},"title":"apidata.AddMemoryResponse"},"apidata.SuccessResponse":{"type":"object","properties":{"message":{"type":"string"}},"title":"apidata.SuccessResponse"},"apidata.CreateUserRequest":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the user."},"fact_rating_instruction":{"$ref":"#/components/schemas/apidata.FactRatingInstruction","description":"Optional instruction to use for fact rating."},"first_name":{"type":"string","description":"The first name of the user."},"last_name":{"type":"string","description":"The last name of the user."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"The metadata associated with the user."},"user_id":{"type":"string","description":"The unique identifier of the user."}},"required":["user_id"],"title":"apidata.CreateUserRequest"},"apidata.User":{"type":"object","properties":{"created_at":{"type":"string"},"deleted_at":{"type":"string"},"email":{"type":"string"},"fact_rating_instruction":{"$ref":"#/components/schemas/models.FactRatingInstruction"},"first_name":{"type":"string"},"id":{"type":"integer"},"last_name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Deprecated"},"project_uuid":{"type":"string"},"session_count":{"type":"integer","description":"Deprecated"},"updated_at":{"type":"string","description":"Deprecated"},"user_id":{"type":"string"},"uuid":{"type":"string"}},"title":"apidata.User"},"apidata.UserListResponse":{"type":"object","properties":{"row_count":{"type":"integer"},"total_count":{"type":"integer"},"users":{"type":"array","items":{"$ref":"#/components/schemas/apidata.User"}}},"title":"apidata.UserListResponse"},"apidata.UpdateUserRequest":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the user."},"fact_rating_instruction":{"$ref":"#/components/schemas/apidata.FactRatingInstruction","description":"Optional instruction to use for fact rating."},"first_name":{"type":"string","description":"The first name of the user."},"last_name":{"type":"string","description":"The last name of the user."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"The metadata to update"}},"title":"apidata.UpdateUserRequest"},"graphiti.EntityNode":{"type":"object","properties":{"attributes":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Additional attributes of the node. Dependent on node labels"},"created_at":{"type":"string","description":"Creation time of the node"},"labels":{"type":"array","items":{"type":"string"},"description":"Labels associated with the node"},"name":{"type":"string","description":"Name of the node"},"summary":{"type":"string","description":"Regional summary of surrounding edges"},"uuid":{"type":"string","description":"UUID of the node"}},"required":["created_at","name","summary","uuid"],"title":"graphiti.EntityNode"},"apidata.UserNodeResponse":{"type":"object","properties":{"node":{"$ref":"#/components/schemas/graphiti.EntityNode"}},"title":"apidata.UserNodeResponse"},"apidata.CreateGroupRequest":{"type":"object","properties":{"description":{"type":"string"},"fact_rating_instruction":{"$ref":"#/components/schemas/apidata.FactRatingInstruction"},"group_id":{"type":"string"},"name":{"type":"string"}},"required":["group_id"],"title":"apidata.CreateGroupRequest"},"apidata.Group":{"type":"object","properties":{"created_at":{"type":"string"},"description":{"type":"string"},"external_id":{"type":"string","description":"Deprecated"},"fact_rating_instruction":{"$ref":"#/components/schemas/apidata.FactRatingInstruction"},"group_id":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"project_uuid":{"type":"string"},"uuid":{"type":"string"}},"title":"apidata.Group"},"apidata.GroupListResponse":{"type":"object","properties":{"groups":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Group"}},"row_count":{"type":"integer"},"total_count":{"type":"integer"}},"title":"apidata.GroupListResponse"},"apidata.UpdateGroupRequest":{"type":"object","properties":{"description":{"type":"string"},"fact_rating_instruction":{"$ref":"#/components/schemas/apidata.FactRatingInstruction"},"name":{"type":"string"}},"title":"apidata.UpdateGroupRequest"},"models.EntityPropertyType":{"type":"string","enum":["Text","Int","Float","Boolean"],"title":"models.EntityPropertyType"},"apidata.EntityProperty":{"type":"object","properties":{"description":{"type":"string","maxLength":500},"name":{"type":"string"},"type":{"$ref":"#/components/schemas/models.EntityPropertyType"}},"required":["description","name","type"],"title":"apidata.EntityProperty"},"apidata.EntityEdgeSourceTarget":{"type":"object","properties":{"source":{"type":"string","description":"Source represents the originating node identifier in the edge type relationship. (optional)"},"target":{"type":"string","description":"Target represents the target node identifier in the edge type relationship. (optional)"}},"title":"apidata.EntityEdgeSourceTarget"},"apidata.EdgeType":{"type":"object","properties":{"description":{"type":"string","maxLength":500},"name":{"type":"string"},"properties":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EntityProperty"}},"source_targets":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EntityEdgeSourceTarget"}}},"required":["description","name"],"title":"apidata.EdgeType"},"apidata.EntityType":{"type":"object","properties":{"description":{"type":"string","maxLength":500},"name":{"type":"string"},"properties":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EntityProperty"}}},"required":["description","name"],"title":"apidata.EntityType"},"apidata.EntityTypeResponse":{"type":"object","properties":{"edge_types":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EdgeType"}},"entity_types":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EntityType"}}},"title":"apidata.EntityTypeResponse"},"apidata.EntityTypeRequest":{"type":"object","properties":{"edge_types":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EdgeType"}},"entity_types":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EntityType"}}},"title":"apidata.EntityTypeRequest"},"models.GraphDataType":{"type":"string","enum":["text","json","message"],"title":"models.GraphDataType"},"apidata.AddDataRequest":{"type":"object","properties":{"created_at":{"type":"string"},"data":{"type":"string"},"group_id":{"type":"string"},"source_description":{"type":"string","maxLength":500},"type":{"$ref":"#/components/schemas/models.GraphDataType"},"user_id":{"type":"string"}},"required":["data","type"],"title":"apidata.AddDataRequest"},"apidata.GraphEpisode":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"processed":{"type":"boolean"},"role":{"type":"string","description":"Optional role, will only be present if the episode was created using memory.add API"},"role_type":{"$ref":"#/components/schemas/apidata.RoleType","description":"Optional role_type, will only be present if the episode was created using memory.add API"},"session_id":{"type":"string"},"source":{"$ref":"#/components/schemas/models.GraphDataType"},"source_description":{"type":"string"},"uuid":{"type":"string"}},"required":["content","created_at","uuid"],"title":"apidata.GraphEpisode"},"apidata.EpisodeData":{"type":"object","properties":{"created_at":{"type":"string"},"data":{"type":"string"},"source_description":{"type":"string","maxLength":500},"type":{"$ref":"#/components/schemas/models.GraphDataType"}},"required":["data","type"],"title":"apidata.EpisodeData"},"apidata.AddDataBatchRequest":{"type":"object","properties":{"episodes":{"type":"array","items":{"$ref":"#/components/schemas/apidata.EpisodeData"}},"group_id":{"type":"string"},"user_id":{"type":"string"}},"required":["episodes"],"title":"apidata.AddDataBatchRequest"},"graphiti.AddTripleRequest":{"type":"object","properties":{"created_at":{"type":"string","description":"The timestamp of the message"},"expired_at":{"type":"string","description":"The time (if any) at which the edge expires"},"fact":{"type":"string","maxLength":50,"description":"The fact relating the two nodes that this edge represents"},"fact_name":{"type":"string","minLength":1,"maxLength":50,"description":"The name of the edge to add. Should be all caps using snake case (eg RELATES_TO)"},"fact_uuid":{"type":"string","description":"The uuid of the edge to add"},"group_id":{"type":"string"},"invalid_at":{"type":"string","description":"The time (if any) at which the fact stops being true"},"source_node_name":{"type":"string","maxLength":50,"description":"The name of the source node to add"},"source_node_summary":{"type":"string","maxLength":500,"description":"The summary of the source node to add"},"source_node_uuid":{"type":"string","description":"The source node uuid"},"target_node_name":{"type":"string","maxLength":50,"description":"The name of the target node to add"},"target_node_summary":{"type":"string","maxLength":500,"description":"The summary of the target node to add"},"target_node_uuid":{"type":"string","description":"The target node uuid"},"user_id":{"type":"string"},"valid_at":{"type":"string","description":"The time at which the fact becomes true"}},"required":["fact","fact_name","target_node_name"],"title":"graphiti.AddTripleRequest"},"graphiti.EntityEdge":{"type":"object","properties":{"attributes":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Additional attributes of the edge. Dependent on edge types"},"created_at":{"type":"string","description":"Creation time of the edge"},"episodes":{"type":"array","items":{"type":"string"},"description":"List of episode ids that reference these entity edges"},"expired_at":{"type":"string","description":"Datetime of when the node was invalidated"},"fact":{"type":"string","description":"Fact representing the edge and nodes that it connects"},"invalid_at":{"type":"string","description":"Datetime of when the fact stopped being true"},"name":{"type":"string","description":"Name of the edge, relation name"},"source_node_uuid":{"type":"string","description":"UUID of the source node"},"target_node_uuid":{"type":"string","description":"UUID of the target node"},"uuid":{"type":"string","description":"UUID of the edge"},"valid_at":{"type":"string","description":"Datetime of when the fact became true"}},"required":["created_at","fact","name","source_node_uuid","target_node_uuid","uuid"],"title":"graphiti.EntityEdge"},"graphiti.AddTripleResponse":{"type":"object","properties":{"edge":{"$ref":"#/components/schemas/graphiti.EntityEdge"},"source_node":{"$ref":"#/components/schemas/graphiti.EntityNode"},"target_node":{"$ref":"#/components/schemas/graphiti.EntityNode"}},"title":"graphiti.AddTripleResponse"},"apidata.CloneGraphRequest":{"type":"object","properties":{"source_group_id":{"type":"string","description":"group_id of the group whose graph is being cloned. Required if user_id is not provided"},"source_user_id":{"type":"string","description":"user_id of the user whose graph is being cloned. Required if group_id is not provided"},"target_group_id":{"type":"string","description":"group_id to be set on the cloned group. Must not point to an existing group. Required if target_user_id is not provided."},"target_user_id":{"type":"string","description":"user_id to be set on the cloned user. Must not point to an existing user. Required if target_group_id is not provided."}},"title":"apidata.CloneGraphRequest"},"apidata.CloneGraphResponse":{"type":"object","properties":{"group_id":{"type":"string"},"user_id":{"type":"string"}},"title":"apidata.CloneGraphResponse"},"graphiti.Reranker":{"type":"string","enum":["rrf","mmr","node_distance","episode_mentions","cross_encoder"],"title":"graphiti.Reranker"},"graphiti.GraphSearchScope":{"type":"string","enum":["edges","nodes","episodes"],"title":"graphiti.GraphSearchScope"},"graphiti.ComparisonOperator":{"type":"string","enum":["=","<>",">","<",">=","<="],"title":"graphiti.ComparisonOperator"},"graphiti.DateFilter":{"type":"object","properties":{"comparison_operator":{"$ref":"#/components/schemas/graphiti.ComparisonOperator","description":"Comparison operator for date filter"},"date":{"type":"string","description":"Date to filter on"}},"required":["comparison_operator","date"],"title":"graphiti.DateFilter"},"graphiti.SearchFilters":{"type":"object","properties":{"created_at":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.DateFilter"}},"description":"2D array of date filters for the created_at field.\nThe outer array elements are combined with OR logic.\nThe inner array elements are combined with AND logic.\nExample: [[{\">\", date1}, {\"<\", date2}], [{\"=\", date3}]]\nThis translates to: (created_at > date1 AND created_at < date2) OR (created_at = date3)"},"edge_types":{"type":"array","items":{"type":"string"},"description":"List of edge types to filter on"},"expired_at":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.DateFilter"}},"description":"2D array of date filters for the expired_at field.\nThe outer array elements are combined with OR logic.\nThe inner array elements are combined with AND logic.\nExample: [[{\">\", date1}, {\"<\", date2}], [{\"=\", date3}]]\nThis translates to: (expired_at > date1 AND expired_at < date2) OR (expired_at = date3)"},"invalid_at":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.DateFilter"}},"description":"2D array of date filters for the invalid_at field.\nThe outer array elements are combined with OR logic.\nThe inner array elements are combined with AND logic.\nExample: [[{\">\", date1}, {\"<\", date2}], [{\"=\", date3}]]\nThis translates to: (invalid_at > date1 AND invalid_at < date2) OR (invalid_at = date3)"},"node_labels":{"type":"array","items":{"type":"string"},"description":"List of node labels to filter on"},"valid_at":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.DateFilter"}},"description":"2D array of date filters for the valid_at field.\nThe outer array elements are combined with OR logic.\nThe inner array elements are combined with AND logic.\nExample: [[{\">\", date1}, {\"<\", date2}], [{\"=\", date3}]]\nThis translates to: (valid_at > date1 AND valid_at < date2) OR (valid_at = date3)"}},"title":"graphiti.SearchFilters"},"graphiti.GraphSearchQuery":{"type":"object","properties":{"bfs_origin_node_uuids":{"type":"array","items":{"type":"string"},"description":"Nodes that are the origins of the BFS searches"},"center_node_uuid":{"type":"string","description":"Node to rerank around for node distance reranking"},"group_id":{"type":"string","description":"one of user_id or group_id must be provided"},"limit":{"type":"integer","maximum":50,"description":"The maximum number of facts to retrieve. Defaults to 10. Limited to 50."},"min_fact_rating":{"type":"number","format":"double","description":"The minimum rating by which to filter relevant facts"},"min_score":{"type":"number","format":"double","description":"Deprecated"},"mmr_lambda":{"type":"number","format":"double","description":"weighting for maximal marginal relevance"},"query":{"type":"string","maxLength":256,"description":"The string to search for (required)"},"reranker":{"$ref":"#/components/schemas/graphiti.Reranker","description":"Defaults to RRF"},"scope":{"$ref":"#/components/schemas/graphiti.GraphSearchScope","description":"Defaults to Edges. Communities will be added in the future."},"search_filters":{"$ref":"#/components/schemas/graphiti.SearchFilters","description":"Search filters to apply to the search"},"user_id":{"type":"string","description":"one of user_id or group_id must be provided"}},"required":["query"],"title":"graphiti.GraphSearchQuery"},"apidata.GraphSearchResults":{"type":"object","properties":{"edges":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityEdge"}},"episodes":{"type":"array","items":{"$ref":"#/components/schemas/apidata.GraphEpisode"}},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityNode"}}},"title":"apidata.GraphSearchResults"},"apidata.GraphEdgesRequest":{"type":"object","properties":{"limit":{"type":"integer","description":"Maximum number of items to return"},"uuid_cursor":{"type":"string","description":"UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page"}},"title":"apidata.GraphEdgesRequest"},"apidata.GraphEpisodeResponse":{"type":"object","properties":{"episodes":{"type":"array","items":{"$ref":"#/components/schemas/apidata.GraphEpisode"}}},"title":"apidata.GraphEpisodeResponse"},"apidata.EpisodeMentions":{"type":"object","properties":{"edges":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityEdge"}},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/graphiti.EntityNode"}}},"title":"apidata.EpisodeMentions"},"apidata.GraphNodesRequest":{"type":"object","properties":{"limit":{"type":"integer","description":"Maximum number of items to return"},"uuid_cursor":{"type":"string","description":"UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page"}},"title":"apidata.GraphNodesRequest"},"apidata.FactResponse":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/apidata.Fact"}},"title":"apidata.FactResponse"},"models.EndSessionsRequest":{"type":"object","properties":{"instruction":{"type":"string"},"session_ids":{"type":"array","items":{"type":"string"}}},"required":["session_ids"],"title":"models.EndSessionsRequest"},"apidata.EndSessionsResponse":{"type":"object","properties":{"sessions":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Session"}}},"title":"apidata.EndSessionsResponse"},"models.SearchScope":{"type":"string","enum":["messages","summary","facts"],"title":"models.SearchScope"},"models.SearchType":{"type":"string","enum":["similarity","mmr"],"title":"models.SearchType"},"models.SessionSearchQuery":{"type":"object","properties":{"min_fact_rating":{"type":"number","format":"double","description":"The minimum fact rating to filter on."},"min_score":{"type":"number","format":"double","description":"The minimum score for search results."},"mmr_lambda":{"type":"number","format":"double","description":"The lambda parameter for the MMR Reranking Algorithm."},"record_filter":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Record filter on the metadata."},"search_scope":{"$ref":"#/components/schemas/models.SearchScope","description":"Search scope."},"search_type":{"$ref":"#/components/schemas/models.SearchType","description":"Search type."},"session_ids":{"type":"array","items":{"type":"string"},"description":"the session ids to search"},"text":{"type":"string","maxLength":256,"description":"The search text."},"user_id":{"type":"string","description":"User ID used to determine which sessions to search."}},"required":["text"],"title":"models.SessionSearchQuery"},"apidata.SessionSearchResult":{"type":"object","properties":{"fact":{"$ref":"#/components/schemas/apidata.Fact"},"message":{"$ref":"#/components/schemas/apidata.Message"},"score":{"type":"number","format":"double"},"session_id":{"type":"string"},"summary":{"$ref":"#/components/schemas/apidata.Summary"}},"title":"apidata.SessionSearchResult"},"apidata.SessionSearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/apidata.SessionSearchResult"}}},"title":"apidata.SessionSearchResponse"},"models.UpdateSessionRequest":{"type":"object","properties":{"fact_rating_instruction":{"$ref":"#/components/schemas/models.FactRatingInstruction","description":"Optional instruction to use for fact rating.\nFact rating instructions can not be unset."},"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Deprecated"}},"required":["metadata"],"title":"models.UpdateSessionRequest"},"models.ClassifySessionRequest":{"type":"object","properties":{"classes":{"type":"array","items":{"type":"string"},"description":"The classes to use for classification."},"instruction":{"type":"string","description":"Custom instruction to use for classification."},"last_n":{"type":"integer","default":4,"description":"The number of session messages to consider for classification. Defaults to 4."},"name":{"type":"string","description":"The name of the classifier."},"persist":{"type":"boolean","default":true,"description":"Deprecated"}},"required":["classes","name"],"title":"models.ClassifySessionRequest"},"apidata.SessionClassification":{"type":"object","properties":{"class":{"type":"string"},"label":{"type":"string"}},"title":"apidata.SessionClassification"},"models.EndSessionRequest":{"type":"object","properties":{"classify":{"$ref":"#/components/schemas/models.ClassifySessionRequest"},"instruction":{"type":"string"}},"title":"models.EndSessionRequest"},"apidata.EndSessionResponse":{"type":"object","properties":{"classification":{"$ref":"#/components/schemas/apidata.SessionClassification"},"session":{"$ref":"#/components/schemas/apidata.Session"}},"title":"apidata.EndSessionResponse"},"apidata.FactsResponse":{"type":"object","properties":{"facts":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Fact"}}},"title":"apidata.FactsResponse"},"apidata.NewFact":{"type":"object","properties":{"fact":{"type":"string"}},"required":["fact"],"title":"apidata.NewFact"},"apidata.AddFactsRequest":{"type":"object","properties":{"facts":{"type":"array","items":{"$ref":"#/components/schemas/apidata.NewFact"}}},"required":["facts"],"title":"apidata.AddFactsRequest"},"models.MessageMetadataUpdate":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Deprecated"}},"required":["metadata"],"title":"models.MessageMetadataUpdate"},"models.MemorySearchPayload":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Metadata Filter"},"min_fact_rating":{"type":"number","format":"double"},"min_score":{"type":"number","format":"double"},"mmr_lambda":{"type":"number","format":"double"},"search_scope":{"$ref":"#/components/schemas/models.SearchScope"},"search_type":{"$ref":"#/components/schemas/models.SearchType"},"text":{"type":"string"}},"title":"models.MemorySearchPayload"},"apidata.MemorySearchResult":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/apidata.Message"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"score":{"type":"number","format":"double"},"summary":{"$ref":"#/components/schemas/apidata.Summary"}},"title":"apidata.MemorySearchResult"},"apidata.SummaryListResponse":{"type":"object","properties":{"row_count":{"type":"integer"},"summaries":{"type":"array","items":{"$ref":"#/components/schemas/apidata.Summary"}},"total_count":{"type":"integer"}},"title":"apidata.SummaryListResponse"},"apidata.Question":{"type":"object","properties":{"question":{"type":"string"}},"title":"apidata.Question"},"apidata.DocumentCollection":{"type":"object","properties":{"created_at":{"type":"string"},"description":{"type":"string"},"document_count":{"type":"integer"},"document_embedded_count":{"type":"integer"},"embedding_dimensions":{"type":"integer"},"embedding_model_name":{"type":"string"},"is_auto_embedded":{"type":"boolean"},"is_indexed":{"type":"boolean"},"is_normalized":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"name":{"type":"string"},"updated_at":{"type":"string"},"uuid":{"type":"string"}},"title":"apidata.DocumentCollection"},"models.CreateDocumentCollectionRequest":{"type":"object","properties":{"description":{"type":"string","maxLength":1000},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"models.CreateDocumentCollectionRequest"},"models.UpdateDocumentCollectionRequest":{"type":"object","properties":{"description":{"type":"string","maxLength":1000},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"models.UpdateDocumentCollectionRequest"},"models.CreateDocumentRequest":{"type":"object","properties":{"content":{"type":"string"},"document_id":{"type":"string","maxLength":100},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["content"],"title":"models.CreateDocumentRequest"},"models.GetDocumentListRequest":{"type":"object","properties":{"document_ids":{"type":"array","items":{"type":"string"}},"uuids":{"type":"array","items":{"type":"string"}}},"title":"models.GetDocumentListRequest"},"apidata.Document":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"document_id":{"type":"string"},"embedding":{"type":"array","items":{"type":"number","format":"double"}},"is_embedded":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"updated_at":{"type":"string"},"uuid":{"type":"string"}},"title":"apidata.Document"},"models.UpdateDocumentListRequest":{"type":"object","properties":{"document_id":{"type":"string","maxLength":40},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"uuid":{"type":"string"}},"required":["uuid"],"title":"models.UpdateDocumentListRequest"},"models.UpdateDocumentRequest":{"type":"object","properties":{"document_id":{"type":"string","maxLength":40},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"models.UpdateDocumentRequest"},"models.DocumentSearchPayload":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Document metadata to filter on."},"min_score":{"type":"number","format":"double"},"mmr_lambda":{"type":"number","format":"double","description":"The lambda parameter for the MMR Reranking Algorithm."},"search_type":{"$ref":"#/components/schemas/models.SearchType","default":"similarity","description":"The type of search to perform. Defaults to \"similarity\". Must be one of \"similarity\" or \"mmr\"."},"text":{"type":"string","description":"The search text."}},"description":"DocumentSearchPayload the payload for searching documents.","title":"models.DocumentSearchPayload"},"apidata.DocumentWithScore":{"type":"object","properties":{"content":{"type":"string"},"created_at":{"type":"string"},"document_id":{"type":"string"},"embedding":{"type":"array","items":{"type":"number","format":"double"}},"is_embedded":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{"description":"Any type"}},"score":{"type":"number","format":"double"},"updated_at":{"type":"string"},"uuid":{"type":"string"}},"title":"apidata.DocumentWithScore"},"apidata.DocumentSearchResponse":{"type":"object","properties":{"current_page":{"type":"integer"},"query_vector":{"type":"array","items":{"type":"number","format":"double"}},"result_count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/apidata.DocumentWithScore"}},"total_pages":{"type":"integer"}},"title":"apidata.DocumentSearchResponse"}}}}