Zep v3

Overview

The "Delete Episode" operation in the Episode resource allows users to delete a specific episode from the Zep Cloud knowledge graph system by providing its unique UUID. This node is useful for managing and maintaining the integrity of your knowledge graph data by removing outdated, incorrect, or irrelevant episodes (events or records) associated with your graphs.

Practical scenarios include:

• Cleaning up old or erroneous event data from your knowledge graph.
• Removing sensitive or deprecated information from your dataset.
• Managing data lifecycle by programmatically deleting episodes as part of automated workflows.

Example: If you have an episode representing a past customer interaction that is no longer relevant, you can use this node to delete it by specifying its UUID.

Properties

Output

The output JSON contains the response from the Zep Cloud API after attempting to delete the specified episode. Typically, this will confirm successful deletion or provide error details if the operation failed.

The structure generally includes fields such as status or confirmation message, but exact fields depend on the API response.

This node does not output binary data.

Dependencies

• Requires an active connection to the Zep Cloud v3 API.
• Requires an API key credential configured in n8n for authenticating requests to the Zep Cloud API.
• Network access to https://api.getzep.com must be available.

Troubleshooting

• Missing UUID: The operation requires the UUID of the episode to delete. Omitting this will cause an error.
• Invalid UUID: Providing an incorrect or non-existent UUID will result in an error indicating the episode was not found.
• Authentication errors: Ensure the API key credential is correctly set up and has permissions to delete episodes.
• Network issues: Connectivity problems to the Zep Cloud API endpoint will cause request failures.
• API rate limits: Excessive requests might trigger rate limiting; handle retries accordingly.

Common error messages:

• "Unknown episode operation: delete" — indicates a misconfiguration of the operation parameter.
• HTTP 404 Not Found — the specified episode UUID does not exist.
• HTTP 401 Unauthorized — invalid or missing API authentication.

Resolving these typically involves verifying input parameters, credentials, and network connectivity.

Links and References

• Zep Cloud API Documentation (for detailed API endpoints and payloads)
• n8n Documentation (for general usage of custom nodes and credentials)