{"record":{"id":"4e99e0bcf5c7e92c","repo":"BerriAI/litellm","slug":"name-is-required-for-ragflow-dataset-creation","errorCode":null,"errorMessage":"name is required for RAGFlow dataset creation","messagePattern":"name is required for RAGFlow dataset creation","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"litellm/llms/ragflow/vector_stores/transformation.py","lineNumber":121,"sourceCode":"        raise NotImplementedError(\"RAGFlow vector stores support dataset management only, not search/retrieval\")\n\n    def transform_create_vector_store_request(\n        self,\n        vector_store_create_optional_params: VectorStoreCreateOptionalRequestParams,\n        api_base: str,\n    ) -> tuple[str, dict]:\n        \"\"\"\n        Transform create request to RAGFlow POST /api/v1/datasets format.\n\n        Maps LiteLLM params to RAGFlow dataset creation parameters.\n        RAGFlow-specific fields can be passed via metadata.\n        \"\"\"\n        url: Final = api_base  # Already includes /api/v1/datasets from get_complete_url\n\n        # Extract name (required by RAGFlow)\n        name: Final = vector_store_create_optional_params.get(\"name\")\n        if not name:\n            raise ValueError(\"name is required for RAGFlow dataset creation\")\n\n        # Build request body\n        request_body: Final[dict[str, Any]] = {\n            \"name\": name,\n        }\n\n        # Extract RAGFlow-specific fields from metadata\n        metadata: Final = vector_store_create_optional_params.get(\"metadata\")\n        if metadata:\n            # RAGFlow-specific fields that can be in metadata\n            ragflow_fields: Final = [\n                \"avatar\",\n                \"description\",\n                \"embedding_model\",\n                \"permission\",\n                \"chunk_method\",\n                \"parser_config\",\n                \"parse_type\",","sourceCodeStart":103,"sourceCodeEnd":139,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/llms/ragflow/vector_stores/transformation.py#L103-L139","documentation":"Required-field guard when building a RAGFlow dataset-creation request: the create params contain no 'name', but the POST /api/v1/datasets API requires a dataset name, so the request body is rejected before it is sent.","triggerScenarios":"Triggered when creating a RAGFlow dataset without providing the required 'name' field.","commonSituations":"See trigger scenarios.","solutions":["Provide a 'name' when creating a RAGFlow dataset/vector store."],"exampleFix":"litellm.vector_stores.create(name=\"my-dataset\", custom_llm_provider=\"ragflow\", ...)","handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}