Zep v3 icon

Zep v3

Interact with Zep Cloud v3 API

Actions44

Overview

The "Add Data" operation for the "Graph" resource in this node allows users to add new data entries into a knowledge graph managed by the Zep Cloud v3 API. This operation supports adding various types of data (text, JSON, or message format) associated with either a specific graph or a user. It is useful for scenarios where you want to enrich a knowledge graph with additional information, such as importing textual content, structured JSON data, or messages that represent knowledge or context.

Practical examples include:

  • Adding customer interaction logs or notes as text data to a customer knowledge graph.
  • Importing structured JSON data representing entities and relationships into a graph.
  • Adding chat messages or conversation snippets as message-type data to enhance contextual understanding within the graph.

This operation requires specifying either a Graph ID or a User ID to associate the data correctly.

Properties

Name Meaning
User ID The unique identifier of the user. Optional if Graph ID is provided; used to associate data with a user’s graph.
Graph ID The unique identifier of the graph. Required for most operations unless User ID is used instead.
Data The actual data content to add to the graph. Can be text, JSON, or message format.
Data Type The type of data being added. Options: Text, JSON, Message.
Created At Optional timestamp for the data in ISO 8601 format, indicating when the data was created.
Source Description Optional description of the source of the data, limited to 500 characters.

Output

The output of this operation is the JSON response returned from the Zep Cloud API after adding the data to the graph. This typically includes confirmation details about the added data entry, such as identifiers, timestamps, and any metadata assigned by the service.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Zep Cloud v3 API.
  • The node makes HTTP POST requests to the endpoint https://api.getzep.com/api/v2/graph to add data.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Error: "Either Graph ID or User ID must be provided for addData operation"
    This error occurs if neither a Graph ID nor a User ID is specified. To resolve, ensure at least one of these identifiers is provided to associate the data correctly.

  • Invalid Timestamp Format
    If the "Created At" property is provided but not in valid ISO 8601 format, the API may reject the request. Use a proper ISO 8601 timestamp string.

  • API Authentication Errors
    Ensure the API key credential is correctly set up and has sufficient permissions to add data to the graph.

  • Data Format Issues
    When specifying JSON or message data types, ensure the data string is properly formatted JSON or message structure as expected by the API.

Links and References

Discussion