{"record":{"id":"a067855f70e637f7","repo":"n8n-io/n8n","slug":"api-key-is-required-to-use-zep-cloud","errorCode":null,"errorMessage":"API key is required to use Zep Cloud","messagePattern":"API key is required to use Zep Cloud","errorType":"exception","errorClass":"NodeOperationError","httpStatus":null,"severity":"error","filePath":"packages/@n8n/nodes-langchain/nodes/memory/MemoryZep/MemoryZep.node.ts","lineNumber":147,"sourceCode":"\t\t\tapiUrl?: string;\n\t\t\tcloud?: boolean;\n\t\t}>('zepApi');\n\n\t\tconst nodeVersion = this.getNode().typeVersion;\n\n\t\tlet sessionId;\n\n\t\tif (nodeVersion >= 1.2) {\n\t\t\tsessionId = getSessionId(this, itemIndex);\n\t\t} else {\n\t\t\tsessionId = this.getNodeParameter('sessionId', itemIndex) as string;\n\t\t}\n\n\t\tlet memory: BaseChatMemory;\n\n\t\tif (credentials.cloud) {\n\t\t\tif (!credentials.apiKey) {\n\t\t\t\tthrow new NodeOperationError(this.getNode(), 'API key is required to use Zep Cloud');\n\t\t\t}\n\t\t\tmemory = new WhiteSpaceTrimmedZepCloudMemory({\n\t\t\t\tsessionId,\n\t\t\t\tapiKey: credentials.apiKey,\n\t\t\t\tmemoryType: 'perpetual',\n\t\t\t\tmemoryKey: 'chat_history',\n\t\t\t\treturnMessages: true,\n\t\t\t\tinputKey: 'input',\n\t\t\t\toutputKey: 'output',\n\t\t\t\tseparateMessages: false,\n\t\t\t});\n\t\t} else {\n\t\t\tif (!credentials.apiUrl) {\n\t\t\t\tthrow new NodeOperationError(this.getNode(), 'API url is required to use Zep Open Source');\n\t\t\t}\n\t\t\tmemory = new ZepMemory({\n\t\t\t\tsessionId,\n\t\t\t\tbaseURL: credentials.apiUrl,","sourceCodeStart":129,"sourceCodeEnd":165,"githubUrl":"https://github.com/n8n-io/n8n/blob/5ac6606e81f67bb9534255570cd4e86fd8101eee/packages/@n8n/nodes-langchain/nodes/memory/MemoryZep/MemoryZep.node.ts#L129-L165","documentation":"Fires in MemoryZep.supplyData when the Zep credential is marked as Zep Cloud but no API key was entered on the credential. Zep Cloud requires the API key for authentication; the node stops the memory supply (and thus the AI chain) at configuration time rather than failing later at runtime with an auth error.","triggerScenarios":"Thrown at packages/@n8n/nodes-langchain/nodes/memory/MemoryZep/MemoryZep.node.ts:147 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add the Zep Cloud API key to the zepApi credential","Or switch to the self-hosted (open source) mode with an API URL"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"5ac6606e81f67bb9534255570cd4e86fd8101eee","analyzedAt":"2026-08-12T05:26:35.080Z","contentChangedAt":"2026-08-12T05:26:35.080Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}