The Zep connector lets your AI agent act in each user's Zep account. Each user connects their own Zep API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 38 · 16 · 638 read16 write6 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Zep connection
In AgentKit > Connections, create a Zep connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'zep'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Zep:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'zep_graph_lookup',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "zep"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Zep:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="zep_graph_lookup",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Zep credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolzep_edge_getGet one edge with its fact, source and target nodes and validity times.Read-onlyGet Edge
Get one edge with its fact, source and target nodes and validity times. Returns the edge object. Get UUIDs from zep_edges_list.
Inputs
edge_uuidstringrequired- UUID of the edge. Get it from zep_edges_list or zep_graph_edges_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_edges_listList a graph's edges (facts), a page at a time, optionally filtered.Read-onlyList Edges
List a graph's edges (facts), a page at a time, optionally filtered. Returns edge objects with their fact, nodes and validity times. Use zep_graph_edges_search for a text query. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
orderstring- Sort direction: asc or desc (default desc). Example: desc.one of
ascdesc order_bystring- Sort key: uuid (default), created_at, or valid_at. Example: created_at.one of
uuidcreated_atvalid_at page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_episode_getGet one episode with its content and processing status.Read-onlyGet Episode
Get one episode with its content and processing status. Returns the episode object. Get UUIDs from zep_episodes_list.
Inputs
episode_uuidstringrequired- UUID of the episode. Get it from zep_episodes_list. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_episodes_listList a graph's episodes, newest first, a page at a time.Read-onlyList Episodes
List a graph's episodes, newest first, a page at a time. Returns episode objects with content and processing status. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
orderstring- Sort direction: asc or desc. Example: desc.one of
ascdesc order_bystring- Sort field. Example: created_at.one of
created_atuuid page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_graph_context_getSearch a graph with a query and assemble the results into a context block for an LLM prompt.Read-onlyAssemble Graph Context
Search a graph with a query and assemble the results into a context block for an LLM prompt. Returns the context string. Use the zep_graph_*_search tools for raw results and zep_thread_context_get for a thread. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
querystringrequired- Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
include_resultsboolean- When true, includes the raw graph results selected for the context block. Example: true.
max_charactersinteger- The maximum number of characters in the assembled context block. Example: 10.
recency_biasstring- Adjusts result selection to favor more recent graph data. Example: off.one of
offmildstrong template_uuidstring- The UUID of a context template used to render the context block. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
zep_graph_edges_searchSearch a graph's facts (edges between entities) by a text query, with optional filters and reranking.Read-onlySearch Graph Edges
Search a graph's facts (edges between entities) by a text query, with optional filters and reranking. Returns the best-matching edges with scores. Use zep_graph_context_get for a ready-made prompt block. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
querystringrequired- Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
bfs_origin_node_uuidsarray- Nodes used as BFS origins for graph-distance-aware retrieval. Example: ["8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e"]
center_node_uuidstring- The node to rank results by distance from. Required when reranker is node_distance. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filter_low_quality_resultsboolean- The default is false. When true, Zep removes low-quality results at the knee of the cross-encoder score curve. The filter never removes a result with a score of 0.9 or more. It keeps at least 5 results, or all results when fewer than 5 are available. The filter only removes results, so a page still returns up to page_size results. Use this field only with reranker cross_encoder. It is not supported for episode search. Invalid combinations return a 400 error. The cutoff is approximate, not guaranteed. When the cross-encoder does not score the results, for example after a timeout, Zep... Example: true.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
mmr_lambdanumber- The diversity weighting used for maximal marginal relevance reranking. Required when reranker is mmr. Example: 0.5.
page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
rerankerstring- How results are reranked: rrf (default), mmr, node_distance, episode_mentions or cross_encoder. Example: rrf.one of
rrfmmrnode_distanceepisode_mentionscross_encoder
zep_graph_episodes_searchSearch a graph's episodes (the raw data added to the graph) by a text query, with optional filters and reranking.Read-onlySearch Graph Episodes
Search a graph's episodes (the raw data added to the graph) by a text query, with optional filters and reranking. Returns the best-matching episodes with scores. Use zep_graph_context_get for a ready-made prompt block. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
querystringrequired- Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
bfs_origin_node_uuidsarray- Nodes used as BFS origins for graph-distance-aware retrieval. Example: ["8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e"]
center_node_uuidstring- The node to rank results by distance from. Required when reranker is node_distance. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filter_low_quality_resultsboolean- The default is false. When true, Zep removes low-quality results at the knee of the cross-encoder score curve. The filter never removes a result with a score of 0.9 or more. It keeps at least 5 results, or all results when fewer than 5 are available. The filter only removes results, so a page still returns up to page_size results. Use this field only with reranker cross_encoder. It is not supported for episode search. Invalid combinations return a 400 error. The cutoff is approximate, not guaranteed. When the cross-encoder does not score the results, for example after a timeout, Zep... Example: true.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
mmr_lambdanumber- The diversity weighting used for maximal marginal relevance reranking. Required when reranker is mmr. Example: 0.5.
page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
rerankerstring- How results are reranked: rrf (default), mmr, node_distance, episode_mentions or cross_encoder. Example: rrf.one of
rrfmmrnode_distanceepisode_mentionscross_encoder
zep_graph_getGet one graph by UUID.Read-onlyGet Graph
Get one graph by UUID. Returns the graph with its name, description and owner. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_graph_instructions_getGet the custom extraction instructions set on a graph.Read-onlyGet Graph Instructions
Get the custom extraction instructions set on a graph. Returns the instructions. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_graph_lookupFind a graph by the developer ID (your own identifier) you gave it.Read-onlyLook Up Graph by Developer ID
Find a graph by the developer ID (your own identifier) you gave it. Returns the matching graph. Use zep_graph_get with a Zep UUID.
Inputs
graph_idstring- The developer-assigned graph ID to resolve to a UUID. Mutually exclusive with user_id and thread_id. Example: product-docs.
thread_idstring- The developer-assigned thread ID to resolve to a UUID. Mutually exclusive with user_id and graph_id. Example: support-chat-2026-01-15.
user_idstring- The developer-assigned user ID to resolve to a UUID. Mutually exclusive with thread_id and graph_id. Example: auth0|64f1c2.
zep_graph_nodes_searchSearch a graph's entities (nodes) by a text query, with optional filters and reranking.Read-onlySearch Graph Nodes
Search a graph's entities (nodes) by a text query, with optional filters and reranking. Returns the best-matching nodes with scores. Use zep_graph_context_get for a ready-made prompt block. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
querystringrequired- Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
bfs_origin_node_uuidsarray- Nodes used as BFS origins for graph-distance-aware retrieval. Example: ["8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e"]
center_node_uuidstring- The node to rank results by distance from. Required when reranker is node_distance. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filter_low_quality_resultsboolean- The default is false. When true, Zep removes low-quality results at the knee of the cross-encoder score curve. The filter never removes a result with a score of 0.9 or more. It keeps at least 5 results, or all results when fewer than 5 are available. The filter only removes results, so a page still returns up to page_size results. Use this field only with reranker cross_encoder. It is not supported for episode search. Invalid combinations return a 400 error. The cutoff is approximate, not guaranteed. When the cross-encoder does not score the results, for example after a timeout, Zep... Example: true.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
mmr_lambdanumber- The diversity weighting used for maximal marginal relevance reranking. Required when reranker is mmr. Example: 0.5.
page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
rerankerstring- How results are reranked: rrf (default), mmr, node_distance, episode_mentions or cross_encoder. Example: rrf.one of
rrfmmrnode_distanceepisode_mentionscross_encoder
zep_graph_observations_searchSearch a graph's observations (insights Zep derived from the data) by a text query, with optional filters and reranking.Read-onlySearch Graph Observations
Search a graph's observations (insights Zep derived from the data) by a text query, with optional filters and reranking. Returns the best-matching observations with scores. Use zep_graph_context_get for a ready-made prompt block. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
querystringrequired- Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
bfs_origin_node_uuidsarray- Nodes used as BFS origins for graph-distance-aware retrieval. Example: ["8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e"]
center_node_uuidstring- The node to rank results by distance from. Required when reranker is node_distance. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filter_low_quality_resultsboolean- The default is false. When true, Zep removes low-quality results at the knee of the cross-encoder score curve. The filter never removes a result with a score of 0.9 or more. It keeps at least 5 results, or all results when fewer than 5 are available. The filter only removes results, so a page still returns up to page_size results. Use this field only with reranker cross_encoder. It is not supported for episode search. Invalid combinations return a 400 error. The cutoff is approximate, not guaranteed. When the cross-encoder does not score the results, for example after a timeout, Zep... Example: true.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
mmr_lambdanumber- The diversity weighting used for maximal marginal relevance reranking. Required when reranker is mmr. Example: 0.5.
page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
rerankerstring- How results are reranked: rrf (default), mmr, node_distance, episode_mentions or cross_encoder. Example: rrf.one of
rrfmmrnode_distanceepisode_mentionscross_encoder
zep_graph_ontology_getGet the custom entity and edge types (ontology) set on a graph.Read-onlyGet Graph Ontology
Get the custom entity and edge types (ontology) set on a graph. Returns the ontology. Use zep_project_ontology_get for the project default. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_graph_thread_summaries_searchSearch a graph's thread summaries by a text query, with optional filters and reranking.Read-onlySearch Graph Thread Summaries
Search a graph's thread summaries by a text query, with optional filters and reranking. Returns the best-matching thread summaries with scores. Use zep_graph_context_get for a ready-made prompt block. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
querystringrequired- Natural-language search query, for example What plan is Jane on? Example: What plan is Jane on?.
bfs_origin_node_uuidsarray- Nodes used as BFS origins for graph-distance-aware retrieval. Example: ["8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e"]
center_node_uuidstring- The node to rank results by distance from. Required when reranker is node_distance. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filter_low_quality_resultsboolean- The default is false. When true, Zep removes low-quality results at the knee of the cross-encoder score curve. The filter never removes a result with a score of 0.9 or more. It keeps at least 5 results, or all results when fewer than 5 are available. The filter only removes results, so a page still returns up to page_size results. Use this field only with reranker cross_encoder. It is not supported for episode search. Invalid combinations return a 400 error. The cutoff is approximate, not guaranteed. When the cross-encoder does not score the results, for example after a timeout, Zep... Example: true.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
mmr_lambdanumber- The diversity weighting used for maximal marginal relevance reranking. Required when reranker is mmr. Example: 0.5.
page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
rerankerstring- How results are reranked: rrf (default), mmr, node_distance, episode_mentions or cross_encoder. Example: rrf.one of
rrfmmrnode_distanceepisode_mentionscross_encoder
zep_graphs_listList the standalone graphs in the project, a page at a time.Read-onlyList Graphs
List the standalone graphs in the project, a page at a time. Returns graph objects with their UUIDs. Use zep_graph_lookup to find a graph by your own ID.
Inputs
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
orderstring- asc or desc. Example: desc.one of
ascdesc order_bystring- Sort field. Example: created_at.one of
created_atnameuuid page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
searchstring- Filters results to graphs whose name, description, or graph ID contains this text. Example: quarterly report.
zep_node_getGet one node with its name, labels, summary and attributes.Read-onlyGet Node
Get one node with its name, labels, summary and attributes. Returns the node object. Get UUIDs from zep_nodes_list.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
node_uuidstringrequired- UUID of the node. Get it from zep_nodes_list or zep_graph_nodes_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
zep_node_neighbors_listList the nodes connected to a node, with the edges between them.Read-onlyList Node Neighbors
List the nodes connected to a node, with the edges between them. Returns neighbor nodes and edges. Get UUIDs from zep_nodes_list.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
node_uuidstringrequired- UUID of the node. Get it from zep_nodes_list or zep_graph_nodes_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
directionstring- The edge orientation to follow from the node: in, out, or both. Example: in.one of
inoutboth filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
orderstring- Sort direction: asc or desc. Example: desc.one of
ascdesc order_bystring- Sort field. Example: created_at.one of
uuidcreated_at page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_nodes_listList a graph's nodes (entities), a page at a time, optionally filtered by label.Read-onlyList Nodes
List a graph's nodes (entities), a page at a time, optionally filtered by label. Returns node objects with name, labels and summary. Use zep_graph_nodes_search for a text query. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
orderstring- Sort direction: asc or desc (default desc). Example: desc.one of
ascdesc order_bystring- Sort key: uuid (default), created_at, or degree. Example: created_at.one of
uuidcreated_atdegree page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_observations_listList the observations Zep derived from a graph's data, a page at a time.Read-onlyList Observations
List the observations Zep derived from a graph's data, a page at a time. Returns observation objects. Use zep_graph_observations_search for a text query. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
orderstring- Sort direction: asc or desc (default desc). Example: desc.one of
ascdesc order_bystring- Sort key: uuid (default) or created_at. Example: created_at.one of
uuidcreated_at page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_project_getGet the Zep project the API key belongs to.Read-onlyGet Project
Get the Zep project the API key belongs to. Returns the project's UUID, name and settings. Use it to test the connection.
Inputs
This tool takes no inputs.
zep_project_instructions_getGet the project-wide custom extraction instructions.Read-onlyGet Project Instructions
Get the project-wide custom extraction instructions. Returns the instructions. Use zep_graph_instructions_get for one graph.
Inputs
This tool takes no inputs.
zep_project_ontology_getGet the project-wide default ontology (entity and edge types).Read-onlyGet Project Ontology
Get the project-wide default ontology (entity and edge types). Returns the ontology. Use zep_graph_ontology_get for one graph.
Inputs
This tool takes no inputs.
zep_task_getGet the status of a background task such as a graph clone.Read-onlyGet Task
Get the status of a background task such as a graph clone. Returns the task with status and progress. Get the task UUID from the call that started it, such as zep_graph_clone.
Inputs
task_uuidstringrequired- UUID of the task returned by the call that started it. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
zep_thread_context_getGet the context block for a thread: the relevant facts, entities and summaries from the user's graph for the latest messages, ready to put in an LLM prompt.Read-onlyGet Thread Context
Get the context block for a thread: the relevant facts, entities and summaries from the user's graph for the latest messages, ready to put in an LLM prompt. Returns the context string. Use zep_graph_context_get for a custom query against any graph. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
Inputs
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
template_uuidstring- Context template UUID. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
zep_thread_episodes_listList the graph episodes created from a thread's messages, with their processing status.Read-onlyList Thread Episodes
List the graph episodes created from a thread's messages, with their processing status. Returns episode objects. Use zep_episode_get for one episode. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
Inputs
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_thread_getGet one thread by Zep UUID.Read-onlyGet Thread
Get one thread by Zep UUID. Returns the thread with its user and graph. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
Inputs
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_thread_lookupFind a thread by the developer ID (your own identifier) you gave it.Read-onlyLook Up Thread by Developer ID
Find a thread by the developer ID (your own identifier) you gave it. Returns the matching thread. Use zep_thread_get with a Zep UUID.
Inputs
graph_idstring- The developer-assigned graph ID to resolve to a UUID. Mutually exclusive with user_id and thread_id. Example: product-docs.
thread_idstring- The developer-assigned thread ID to resolve to a UUID. Mutually exclusive with user_id and graph_id. Example: support-chat-2026-01-15.
user_idstring- The developer-assigned user ID to resolve to a UUID. Mutually exclusive with thread_id and graph_id. Example: auth0|64f1c2.
zep_thread_message_getGet one message from a thread.Read-onlyGet Thread Message
Get one message from a thread. Returns the message object. Get message UUIDs from zep_thread_messages_list.
Inputs
message_uuidstringrequired- UUID of the message. Get it from zep_thread_messages_list. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_thread_messages_listList the messages in a thread, a page at a time.Read-onlyList Thread Messages
List the messages in a thread, a page at a time. Returns message objects with role, content and time. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
Inputs
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
orderstring- Sort direction: asc or desc. Example: desc.one of
ascdesc order_bystring- Sort field. Example: created_at.one of
created_at page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_thread_summaries_listList the thread summaries stored in a graph, a page at a time.Read-onlyList Thread Summaries
List the thread summaries stored in a graph, a page at a time. Returns summary objects. Use zep_graph_thread_summaries_search for a text query. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
filtersobject- Filters that narrow the search, as a JSON object (for example node_labels, edge_types, created_at ranges). Example: {"node_labels": ["Person"]}
orderstring- Sort direction: asc or desc (default desc). Example: desc.one of
ascdesc order_bystring- Sort key: uuid (default) or created_at. Example: created_at.one of
uuidcreated_at page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
zep_thread_summary_getGet the running summary Zep keeps of a thread.Read-onlyGet Thread Summary
Get the running summary Zep keeps of a thread. Returns the summary text. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
Inputs
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_threads_listList the threads in the project, a page at a time, newest or oldest first.Read-onlyList Threads
List the threads in the project, a page at a time, newest or oldest first. Returns thread objects with their user. Use zep_thread_lookup to find a thread by your own ID.
Inputs
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
orderstring- asc or desc. Example: desc.one of
ascdesc order_bystring- Sort field. Example: created_at.one of
created_atupdated_atuuid page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
user_uuidstring- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_user_getGet one user by Zep UUID with name, email and metadata.Read-onlyGet User
Get one user by Zep UUID with name, email and metadata. Returns the user object. Get user UUIDs from zep_users_list or zep_user_lookup.
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_user_get_by_emailFind a user by email address.Read-onlyGet User by Email
Find a user by email address. Returns the matching user. Use zep_user_lookup for your own IDs.
Inputs
emailstringrequired- The user's email address. Matching ignores case and leading and trailing whitespace. Example: jane.doe@example.com.
zep_user_lookupFind a user by the developer ID (your own identifier) you gave it.Read-onlyLook Up User by Developer ID
Find a user by the developer ID (your own identifier) you gave it. Returns the matching user. Use zep_user_get when you already have the Zep UUID.
Inputs
graph_idstring- The developer-assigned graph ID to resolve to a UUID. Mutually exclusive with user_id and thread_id. Example: product-docs.
thread_idstring- The developer-assigned thread ID to resolve to a UUID. Mutually exclusive with user_id and graph_id. Example: support-chat-2026-01-15.
user_idstring- The developer-assigned user ID to resolve to a UUID. Mutually exclusive with thread_id and graph_id. Example: auth0|64f1c2.
zep_user_node_getGet the node that represents the user in their knowledge graph, with its summary.Read-onlyGet User Node
Get the node that represents the user in their knowledge graph, with its summary. Returns the node. Use zep_nodes_list for other nodes. Get user UUIDs from zep_users_list or zep_user_lookup.
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_user_summary_instructions_getGet the custom instructions Zep follows when summarising this user.Read-onlyGet User Summary Instructions
Get the custom instructions Zep follows when summarising this user. Returns the instructions. Get user UUIDs from zep_users_list or zep_user_lookup.
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_users_listList the users in the project, a page at a time.Read-onlyList Users
List the users in the project, a page at a time. Returns user objects with their UUIDs. Use zep_user_lookup to find users by your own IDs and zep_user_get_by_email by email.
Inputs
cursorstring- Opaque page cursor from the previous response, to get the next page. Example: eyJvZmZzZXQiOjUwfQ.
orderstring- asc or desc. Example: desc.one of
ascdesc order_bystring- Sort field. Example: created_at.one of
created_atuser_idemailuuid page_sizeinteger- Maximum number of items in one page. Defaults to 50. Example: 50.
searchstring- Filters results to users whose user ID, email, or name contains this text. Example: quarterly report.
zep_edge_updateUpdate an edge's fact, name, attributes or validity times.WriteUpdate Edge
Update an edge's fact, name, attributes or validity times. Returns the updated edge. Get UUIDs from zep_edges_list.
Inputs
edge_uuidstringrequired- UUID of the edge. Get it from zep_edges_list or zep_graph_edges_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
attributesobject- Additional attributes to merge onto the edge; a key set to null is removed. Example: {"price": "$49"}
factstring- The fact text describing the relationship between the source and target nodes. Example: Jane is on the Pro plan.
zep_edges_addAdd facts as edges between existing nodes of a graph.WriteAdd Edges
Add facts as edges between existing nodes of a graph. Returns the created edges. Get node UUIDs from zep_nodes_list. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
edgesarrayrequired- Edges to add, each with the source and target node UUIDs, a name (relation type) and the fact text, plus optional validity times. Example: [{"source_node_uuid": "3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d", "target_node_uuid": "8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e", "name": "SUBSCRIBED_TO", "fact": "J...
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
deduplicateboolean- When true, Zep compares each edge with graph edges and can merge a duplicate or invalidate a contradicted edge. This adds an LLM call per edge. The default is false. Example: true.
zep_episode_addAdd data to a graph as an episode: text, a JSON document or a message, which Zep processes into nodes and edges in the background.WriteAdd Episode
Add data to a graph as an episode: text, a JSON document or a message, which Zep processes into nodes and edges in the background. Returns the episode with its processing status. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
datastringrequired- The episode content to add to the graph. Example: Jane upgraded to the Pro plan on 2026-01-15.
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
document_idstring- Groups this episode as a chunk of a document on the graph. Example: pricing-faq.
metadataobject- Key-value metadata to store, as a JSON object. Example: {"plan": "pro"}
reference_timestring- The episode's reference time, used for temporal reasoning rather than ingestion time. Defaults to the ingestion time. Example: 2026-01-15T09:30:00Z.
source_descriptionstring- A description of the source of this episode. Example: Support chat transcript.
strict_ontologyboolean- When true, prevents extraction of generic entity nodes that do not match the configured ontology. Example: true.
typestring- The data format of the episode: text, json, or message. Defaults to text. Example: text.one of
textjsonmessage
zep_graph_cloneCopy a graph (or a user's graph) into a new graph or user, for testing or templates.WriteClone Graph
Copy a graph (or a user's graph) into a new graph or user, for testing or templates. Returns the new graph or user and a task to poll with zep_task_get. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_graph_createCreate a standalone knowledge graph (not tied to a user) with a developer ID, name and description.WriteCreate Graph
Create a standalone knowledge graph (not tied to a user) with a developer ID, name and description. Returns the graph with its Zep UUID. Add data with zep_episode_add.
Inputs
content_policyobject- Content policy additions for the graph. The graph binds the current project content policy plus these additions, and the binding does not change after creation. Example: {"rules": []}
descriptionstring- A description of the graph. Example: Knowledge graph of the product documentation.
namestring- A display name for the graph. Example: Product docs.
time_zonestring- The graph's IANA time zone. Example: America/New_York.
zep_graph_instructions_setReplace a graph's custom extraction instructions, which tell Zep what to focus on when building the graph.WriteSet Graph Instructions
Replace a graph's custom extraction instructions, which tell Zep what to focus on when building the graph. Returns the saved instructions. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
- Idempotent
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
instructionsarray- Instructions to apply, each an object with a short name and the instruction text. This replaces the existing instructions at this scope. Example: [{"name": "billing-focus", "text": "Focus on the customer's plan, billing issues and product feedback."}]
zep_graph_ontology_setReplace a graph's custom entity and edge types (ontology), which guide what Zep extracts.WriteSet Graph Ontology
Replace a graph's custom entity and edge types (ontology), which guide what Zep extracts. Returns the saved ontology. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
- Idempotent
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
edge_typesarray- Edge (fact) types to extract, each with a name, a description, optional properties and the source and target entity types it connects. Example: [{"name": "SUBSCRIBED_TO", "description": "A customer subscribed to a plan", "source_targets": [{"source": "Person", "target": "Plan"}]}]
entity_typesarray- Entity types to extract, each with a name, a description and optional typed properties (text, int, float, boolean, datetime). Example: [{"name": "Plan", "description": "A subscription plan", "properties": [{"name": "price", "type": "text", "description": "Monthly price"}]}]
zep_graph_updateUpdate a graph's name, description or developer ID.WriteUpdate Graph
Update a graph's name, description or developer ID. Returns the updated graph. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
descriptionstring- A description of the graph. Example: Knowledge graph of the product documentation.
namestring- The graph's display name. Example: Product docs.
time_zonestring- The graph's IANA time zone. Example: America/New_York.
zep_node_updateUpdate a node's name, labels, summary or attributes.WriteUpdate Node
Update a node's name, labels, summary or attributes. Returns the updated node. Get UUIDs from zep_nodes_list.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
node_uuidstringrequired- UUID of the node. Get it from zep_nodes_list or zep_graph_nodes_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
attributesobject- Additional attributes to merge onto the node; a key set to null is removed. Example: {"price": "$49"}
namestring- The node's name. Example: Product docs.
summarystring- A summary of the node. Example: Jane is a Pro customer interested in SSO.
zep_nodes_addAdd entities as nodes to a graph, with labels, summary and attributes.WriteAdd Nodes
Add entities as nodes to a graph, with labels, summary and attributes. Returns the created nodes. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
nodesarrayrequired- Nodes to add, each with a name and optionally labels (entity types), a summary and attributes. Example: [{"name": "Pro plan", "labels": ["Plan"], "summary": "The paid Pro subscription tier"}]
zep_project_instructions_setReplace the project-wide custom extraction instructions applied to every graph.WriteSet Project Instructions
Replace the project-wide custom extraction instructions applied to every graph. Returns the saved instructions. Use zep_graph_instructions_set for one graph.
- Idempotent
Inputs
instructionsarray- Instructions to apply, each an object with a short name and the instruction text. This replaces the existing instructions at this scope. Example: [{"name": "billing-focus", "text": "Focus on the customer's plan, billing issues and product feedback."}]
zep_thread_createCreate a conversation thread for a user.WriteCreate Thread
Create a conversation thread for a user. Returns the thread with its Zep UUID. Add messages with zep_thread_messages_add. Get user UUIDs from zep_users_list or zep_user_lookup.
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_thread_messages_addAdd one or more chat messages to a thread; Zep stores them and extracts facts into the user's graph in the background.WriteAdd Thread Messages
Add one or more chat messages to a thread; Zep stores them and extracts facts into the user's graph in the background. Returns the stored messages and, with return_context, the updated context block. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
Inputs
messagesarrayrequired- Messages to add, each with a role (user, assistant, system, tool, ...), the content and optionally the speaker's name, created_at and metadata. Example: [{"role": "user", "name": "Jane", "content": "I just upgraded to Pro."}]
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
ignore_rolesarray- Message roles to skip during graph extraction; the messages are still stored. Example: ["assistant"]
return_contextboolean- When true, returns the context block for the thread's most recent messages. Example: true.
strict_ontologyboolean- When true, prevents extraction of generic entity nodes that do not match the configured ontology. Example: true.
zep_user_createCreate a user in the Zep project, with optional name, email, external ID and metadata; Zep creates the user's knowledge graph.WriteCreate User
Create a user in the Zep project, with optional name, email, external ID and metadata; Zep creates the user's knowledge graph. Returns the user with its Zep UUID. Use zep_thread_create next to start a conversation thread for the user.
Inputs
content_policyobject- Content policy additions for the user's graph. The graph binds the current project content policy plus these additions, and the binding does not change after creation. Example: {"rules": []}
disable_default_ontologyboolean- When true, disables the default ontology for the user's graph. Example: true.
emailstring- The email address of the user. Example: jane.doe@example.com.
first_namestring- The user's first name. Example: Jane.
last_namestring- The user's last name. Example: Doe.
metadataobject- Key-value metadata to store, as a JSON object. Example: {"plan": "pro"}
time_zonestring- The user's IANA time zone. Example: America/New_York.
user_idstring- An optional external identity identifier, such as an identity-provider subject claim. Zep uses it to match an identity-provider sign-in to this user. It is not an address; use uuid to address the user in v4. It is unique within the project, can contain at most 500 characters, and cannot be changed after creation. Example: auth0|64f1c2.
zep_user_summary_instructions_setReplace the custom instructions Zep follows when summarising this user.WriteSet User Summary Instructions
Replace the custom instructions Zep follows when summarising this user. Returns the saved instructions. Get user UUIDs from zep_users_list or zep_user_lookup.
- Idempotent
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
instructionsarray- Instructions to apply, each an object with a short name and the instruction text. This replaces the existing instructions at this scope. Example: [{"name": "billing-focus", "text": "Focus on the customer's plan, billing issues and product feedback."}]
zep_user_updateUpdate a user's name, email, time zone or metadata.WriteUpdate User
Update a user's name, email, time zone or metadata. Returns the updated user. Get user UUIDs from zep_users_list or zep_user_lookup.
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
disable_default_ontologyboolean- When true, disables the default ontology for the user's graph. Example: true.
emailstring- The email address of the user. Example: jane.doe@example.com.
first_namestring- The user's first name. Example: Jane.
last_namestring- The user's last name. Example: Doe.
metadataobject- Key-value metadata to store, as a JSON object. Example: {"plan": "pro"}
time_zonestring- The user's IANA time zone. Example: America/New_York.
zep_edge_deleteDelete an edge (fact) from a graph.DestructiveDelete Edge
Delete an edge (fact) from a graph. Returns an empty response. Get UUIDs from zep_edges_list.
- Idempotent
Inputs
edge_uuidstringrequired- UUID of the edge. Get it from zep_edges_list or zep_graph_edges_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_episode_deleteDelete an episode and the edges that only it supports.DestructiveDelete Episode
Delete an episode and the edges that only it supports. Returns an empty response. Get UUIDs from zep_episodes_list.
- Idempotent
Inputs
episode_uuidstringrequired- UUID of the episode. Get it from zep_episodes_list. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_graph_deleteDelete a graph with all its nodes, edges and episodes.DestructiveDelete Graph
Delete a graph with all its nodes, edges and episodes. Returns an empty response. Get graph UUIDs from zep_graphs_list; for a user's graph pass the user's UUID.
- Idempotent
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_node_deleteDelete a node and its edges from a graph.DestructiveDelete Node
Delete a node and its edges from a graph. Returns an empty response. Get UUIDs from zep_nodes_list.
- Idempotent
Inputs
graph_uuidstringrequired- Zep UUID of the graph. For a user's graph you can also pass the user's UUID. Get graph UUIDs from zep_graphs_list. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
node_uuidstringrequired- UUID of the node. Get it from zep_nodes_list or zep_graph_nodes_search. Example: 8a1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e.
zep_thread_deleteDelete a thread and its messages.DestructiveDelete Thread
Delete a thread and its messages. Facts already extracted into the user's graph stay. Returns an empty response. Get thread UUIDs from zep_threads_list or zep_thread_lookup.
- Idempotent
Inputs
thread_uuidstringrequired- Zep UUID of the thread. Get it from zep_threads_list or zep_thread_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
zep_user_deleteDelete a user with their threads and knowledge graph.DestructiveDelete User
Delete a user with their threads and knowledge graph. Returns an empty response. Get user UUIDs from zep_users_list or zep_user_lookup.
- Idempotent
Inputs
user_uuidstringrequired- Zep UUID of the user. Get it from zep_users_list or zep_user_lookup. Example: 3f2b8c1e-7d4a-4e5b-9c6d-2a1b0e9f8c7d.
No tools match.