Zep v3

Overview

This node integrates with the Zep Cloud v3 API to manage users within the Zep system. Specifically, the "Delete User" operation allows you to remove a user by their unique identifier. This is useful in scenarios where you need to programmatically clean up or revoke access for users who are no longer active or authorized.

Practical examples include:

• Automatically deleting users from your knowledge graph system when they leave an organization.
• Cleaning up test or temporary users created during automated workflows.
• Managing user lifecycle events in synchronization with other systems.

Properties

Output

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

The structure generally includes fields such as status codes and messages returned by the API. No binary data is involved in this operation.

Example output (simplified):

{
  "status": "success",
  "message": "User deleted successfully"
}

or in case of failure:

{
  "error": "User not found"
}

Dependencies

• Requires an API key credential configured in n8n for authenticating requests to the Zep Cloud API.
• The node makes HTTP DELETE requests to https://api.getzep.com/api/v2/users/{userId} endpoint.
• Ensure that the API key has sufficient permissions to delete users.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent User ID will result in an error indicating the user was not found.
  • Missing or incorrect API authentication will cause authorization errors.
  • Network connectivity issues can prevent the request from completing.

• Error messages and resolutions:

  • "User not found": Verify the User ID is correct and exists in the system.
  • "Unauthorized" or similar: Check that the API key credential is valid and has delete permissions.
  • "Request failed" or timeout errors: Confirm network access to the Zep API endpoint.

Links and References

• Zep Cloud API Documentation (general reference for API endpoints)
• n8n documentation on HTTP Request Authentication (for setting up API credentials)