n8n-io/n8n · error · NodeOperationError

API url is required to use Zep Open Source

Error message

API url is required to use Zep Open Source

What it means

Fires in MemoryZep.supplyData when the Zep credential targets self-hosted Zep (cloud: false) but no API URL was provided. The open-source Zep server has no default endpoint the node could fall back to, so the memory cannot be constructed; the error surfaces the missing-credential problem during node configuration instead of as a connection failure mid-run.

Solutions

1. Set the Zep server URL in the zepApi credential
2. Or switch to Zep Cloud mode with an API key

When it happens

Trigger: Thrown at packages/@n8n/nodes-langchain/nodes/memory/MemoryZep/MemoryZep.node.ts:161 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of n8n-io/n8n@5ac6606e81 (2026-08-12). Data as JSON: /api/errors/420ea789e4bf273d. Report an issue: GitHub.

Appendix: source

Thrown at packages/@n8n/nodes-langchain/nodes/memory/MemoryZep/MemoryZep.node.ts:161

		let memory: BaseChatMemory;

		if (credentials.cloud) {
			if (!credentials.apiKey) {
				throw new NodeOperationError(this.getNode(), 'API key is required to use Zep Cloud');
			}
			memory = new WhiteSpaceTrimmedZepCloudMemory({
				sessionId,
				apiKey: credentials.apiKey,
				memoryType: 'perpetual',
				memoryKey: 'chat_history',
				returnMessages: true,
				inputKey: 'input',
				outputKey: 'output',
				separateMessages: false,
			});
		} else {
			if (!credentials.apiUrl) {
				throw new NodeOperationError(this.getNode(), 'API url is required to use Zep Open Source');
			}
			memory = new ZepMemory({
				sessionId,
				baseURL: credentials.apiUrl,
				apiKey: credentials.apiKey,
				memoryKey: 'chat_history',
				returnMessages: true,
				inputKey: 'input',
				outputKey: 'output',
			});
		}

		return {
			response: logWrapper(memory, this),
		};
	}
}

View on GitHub (pinned to 5ac6606e81)