{"record":{"id":"42ad81ddf32e3d93","repo":"HKUDS/DeepTutor","slug":"both-name-and-folder-path-are-required","errorCode":null,"errorMessage":"Both name and folder_path are required.","messagePattern":"Both name and folder_path are required\\.","errorType":"http","errorClass":"HTTPException","httpStatus":400,"severity":"error","filePath":"deeptutor/api/routers/knowledge.py","lineNumber":1815,"sourceCode":"    except ValueError as e:\n        raise HTTPException(status_code=400, detail=str(e))\n    result = probe_linked_folder(str(folder), payload.rag_provider)\n    return result.to_dict()\n\n\n@router.post(\"/connect-folder\")\nasync def connect_linked_folder_route(payload: ConnectFolderRequest):\n    \"\"\"Mount an existing engine index as a read-only ``linked`` knowledge base.\n\n    Re-probes server-side (never trusts the client's verdict), then registers a\n    pointer to the folder. Retrieval reads the index in place — no copy, no\n    re-index. Embedding-mismatch warnings do not block the link (the user may\n    switch embedding models later); a missing/invalid index does.\n    \"\"\"\n    name = (payload.name or \"\").strip()\n    folder_path = (payload.folder_path or \"\").strip()\n    if not name or not folder_path:\n        raise HTTPException(status_code=400, detail=\"Both name and folder_path are required.\")\n    try:\n        folder = assert_path_allowed(folder_path)\n    except ValueError as e:\n        raise HTTPException(status_code=400, detail=str(e))\n\n    result = probe_linked_folder(str(folder), payload.rag_provider)\n    if not result.ok:\n        raise HTTPException(status_code=400, detail=result.error or \"Folder is not linkable.\")\n\n    stats = {\n        \"embedding_model\": result.embedding.index_model,\n        \"doc_count\": result.doc_count,\n    }\n    try:\n        manager = get_kb_manager()\n        entry = manager.register_linked_kb(\n            name,\n            str(folder),","sourceCodeStart":1797,"sourceCodeEnd":1833,"githubUrl":"https://github.com/HKUDS/DeepTutor/blob/3e82f130422a813cdd73c10b21a44e9325f5821a/deeptutor/api/routers/knowledge.py#L1797-L1833","documentation":"Error \"Both name and folder_path are required.\" thrown in HKUDS/DeepTutor.","triggerScenarios":"Thrown at deeptutor/api/routers/knowledge.py:1815 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"3e82f130422a813cdd73c10b21a44e9325f5821a","analyzedAt":"2026-08-27T06:57:25.364Z","schemaVersion":2},"datasetVersion":"2026-08-27T08:17:20.692Z"}