{"record":{"id":"92f628e0b0a5140f","repo":"n8n-io/n8n","slug":"collection-collectionname-not-found","errorCode":null,"errorMessage":"Collection ${collectionName} not found","messagePattern":"Collection (.+?) not found","errorType":"exception","errorClass":"NodeOperationError","httpStatus":null,"severity":"error","filePath":"packages/@n8n/nodes-langchain/nodes/vector_store/VectorStoreZep/VectorStoreZep.node.ts","lineNumber":142,"sourceCode":"\t\t\tcollectionName,\n\t\t\tembeddingDimensions: options.embeddingDimensions ?? 1536,\n\t\t\tisAutoEmbedded: options.isAutoEmbedded ?? true,\n\t\t};\n\n\t\ttry {\n\t\t\tif (credentials.cloud) {\n\t\t\t\tawait ZepCloudVectorStore.fromDocuments(documents, embeddings, zepConfig);\n\t\t\t} else {\n\t\t\t\tawait ZepVectorStore.fromDocuments(documents, embeddings, {\n\t\t\t\t\t...zepConfig,\n\t\t\t\t\tapiUrl: credentials.apiUrl,\n\t\t\t\t});\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst errorCode = (error as IDataObject).code as number;\n\t\t\tconst responseData = (error as IDataObject).responseData as string;\n\t\t\tif (errorCode === 400 && responseData.includes('CreateDocumentCollectionRequest')) {\n\t\t\t\tthrow new NodeOperationError(context.getNode(), `Collection ${collectionName} not found`, {\n\t\t\t\t\titemIndex,\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t'Please check that the collection exists in your vector store, or make sure that collection name contains only alphanumeric characters',\n\t\t\t\t});\n\t\t\t}\n\t\t\tthrow new NodeOperationError(context.getNode(), error as Error, { itemIndex });\n\t\t}\n\t},\n}) {}\n","sourceCodeStart":124,"sourceCodeEnd":152,"githubUrl":"https://github.com/n8n-io/n8n/blob/5ac6606e81f67bb9534255570cd4e86fd8101eee/packages/@n8n/nodes-langchain/nodes/vector_store/VectorStoreZep/VectorStoreZep.node.ts#L124-L152","documentation":"Thrown in the Zep vector store populate path when Zep rejects with HTTP 400 and the responseData text contains 'CreateDocumentCollectionRequest'. n8n interprets that combination as the target collection not existing / not being auto-creatable, and surfaces a friendlier message. The message also warns that collection names must be alphanumeric.","triggerScenarios":"ZepCloudVectorStore.fromDocuments (cloud) or ZepVectorStore.fromDocuments (self-hosted) rejects with error.code === 400 and error.responseData includes 'CreateDocumentCollectionRequest' — i.e. Zep tried to auto-create the collection and the request was invalid (most often because collectionName contains non-alphanumeric characters).","commonSituations":"collectionName has spaces, hyphens, underscores-as-separators, or other symbols Zep rejects; collection does not exist and isAutoEmbedded/auto-create is blocked; Zep cloud vs self-hosted API mismatch; collection name derived from an unsanitized user input.","solutions":["Set collectionName to alphanumeric characters only (letters and digits), e.g. 'memories' not 'my-memories' or 'Memories!'.","Pre-create the collection in Zep if auto-create is disabled or failing.","Confirm the zepApi credential cloud flag matches your actual Zep deployment (cloud vs self-hosted apiUrl).","Sanitize any user-derived collection name (strip/replace non-alphanumerics) before passing it to the node."],"exampleFix":"// before: collectionName = 'my-memories_v1'\n// after:  collectionName = 'mymemoriesv1'","handlingStrategy":"validation","validationCode":"function sanitizeCollectionName(name: string): string { return name.replace(/[^a-zA-Z0-9]/g, ''); } if (!/^[a-zA-Z0-9]+$/.test(collectionName)) { collectionName = sanitizeCollectionName(collectionName); }","typeGuard":"function isAlphanumericCollection(name: unknown): name is string { return typeof name === 'string' && /^[a-zA-Z0-9]+$/.test(name); }","tryCatchPattern":"try { await ZepVectorStore.fromDocuments(...) } catch (e) { if (e.code === 400 && /CreateDocumentCollectionRequest/.test(String(e.responseData))) { /* sanitize name and retry */ } else throw e; }","preventionTips":["Restrict collection names to alphanumerics at the input boundary.","If collection auto-create is unreliable, pre-create collections in Zep.","Match the zepApi cloud flag to your real deployment (cloud vs self-hosted).","Sanitize user-derived names before they reach the node parameter."],"tags":["zep","vector-store","collection","config","naming"],"backgroundTag":null,"analyzedSha":"5ac6606e81f67bb9534255570cd4e86fd8101eee","analyzedAt":"2026-08-12T05:26:35.080Z","schemaVersion":2},"datasetVersion":"2026-08-12T13:17:24.610Z"}