{"record":{"id":"c018bce0a94b7873","repo":"BerriAI/litellm","slug":"vector-store-id-must-be-in-format-bucket-name-ind","errorCode":null,"errorMessage":"vector_store_id must be in format 'bucket_name:index_name' for S3 Vectors, or vector_bucket_name must be provided in litellm_params","messagePattern":"vector_store_id must be in format 'bucket_name:index_name' for S3 Vectors, or vector_bucket_name must be provided in litellm_params","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"litellm/llms/s3_vectors/vector_stores/transformation.py","lineNumber":90,"sourceCode":"        vector_store_search_optional_params: VectorStoreSearchOptionalRequestParams,\n        api_base: str,\n        litellm_logging_obj: LiteLLMLoggingObj,\n        litellm_params: dict,\n        extra_body: dict[str, Any] | None = None,\n    ) -> tuple[str, dict]:\n        \"\"\"Sync version - generates embedding synchronously.\"\"\"\n        # For S3 Vectors, vector_store_id should be in format: bucket_name:index_name\n        # If not in that format, try to construct it from litellm_params\n        bucket_name: str\n        index_name: str\n\n        if \":\" in vector_store_id:\n            bucket_name, index_name = vector_store_id.split(\":\", 1)\n        else:\n            # Try to get bucket_name from litellm_params\n            bucket_name_from_params: Final = litellm_params.get(\"vector_bucket_name\")\n            if not bucket_name_from_params or not isinstance(bucket_name_from_params, str):\n                raise ValueError(\n                    \"vector_store_id must be in format 'bucket_name:index_name' for S3 Vectors, \"\n                    \"or vector_bucket_name must be provided in litellm_params\"\n                )\n            bucket_name = bucket_name_from_params\n            index_name = vector_store_id\n\n        if isinstance(query, list):\n            query = \" \".join(query)\n\n        # Generate embedding for the query\n        embedding_model: Final = litellm_params.get(\"embedding_model\", \"text-embedding-3-small\")\n\n        import litellm as litellm_module\n\n        embedding_response: Final = litellm_module.embedding(model=embedding_model, input=[query])\n        query_embedding: Final = embedding_response.data[0][\"embedding\"]\n\n        url: Final = f\"{api_base}/QueryVectors\"","sourceCodeStart":72,"sourceCodeEnd":108,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/llms/s3_vectors/vector_stores/transformation.py#L72-L108","documentation":"Search request guard: the vector_store_id lacks the required 'bucket_name:index_name' form and no vector_bucket_name in litellm_params allows reconstructing it, so the S3 Vectors index cannot be addressed.","triggerScenarios":"Triggered when vector_store_id is not in 'bucket_name:index_name' format and vector_bucket_name is not provided in litellm_params.","commonSituations":"See trigger scenarios.","solutions":["Format vector_store_id as 'bucket_name:index_name'.","Or provide vector_bucket_name in litellm_params."],"exampleFix":"vector_store_id=\"my-bucket:my-index\"","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-14T05:17:10.506Z"}