Zep v3 icon

Zep v3

Interact with Zep Cloud v3 API

Overview

The "Get Graph Nodes" operation of the Zep node allows users to retrieve all nodes associated with a specific graph in the Zep Cloud v3 API. This is useful for scenarios where you want to analyze, visualize, or process the entities (nodes) within a knowledge graph. For example, you might use this operation to fetch all customer entities in a customer interaction graph or all product entities in a product knowledge base.

Properties

Name Meaning
Graph ID The unique identifier of the graph from which to retrieve nodes. Required for this operation.

Output

The output JSON contains an array of node objects retrieved from the specified graph. Each node object represents an entity within the graph and includes its properties as defined by the Zep API. The exact structure depends on the API response but typically includes identifiers, labels, metadata, and other relevant node details.

This operation does not output binary data.

Dependencies

  • Requires an API key credential for authenticating requests to the Zep Cloud v3 API.
  • The node uses HTTP requests to https://api.getzep.com endpoints.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

  • Missing Graph ID: If neither a Graph ID nor User ID is provided when required, the node will throw an error indicating that one must be supplied.
  • Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Unknown Operation Error: Selecting an unsupported operation for the "node" resource will result in an error message specifying the unknown operation.
  • Empty Results: If the graph ID is valid but no nodes are returned, verify that the graph actually contains nodes.

Links and References

Discussion