---
title: "Test vector store connection with raw credentials"
method: POST
path: "/vector-stores/test"
tags: ["VectorStore"]
---

# Test vector store connection with raw credentials

`POST /vector-stores/test`

Test connectivity using provided credentials without persisting. Returns detected server version.

## Request body

- InternalHandlerTestStoreRequest
  - `connection_config` GithubComTencentWeKnoraInternalTypesConnectionConfig, required
    - `addr` string — Common
    - `api_key` string — AES-GCM encrypted
    - `database` string — Database name used by engines that support database-level namespaces (currently Milvus, Tencent VectorDB, and Doris).
    - `grpc_address` string — Weaviate
    - `host` string — Qdrant
    - `http_port` integer — Doris: HTTP port for Stream Load API (FE default 8030). Addr is reused for the MySQL protocol "host:9030"; HTTPPort + the host of Addr together form the FE HTTP endpoint used by Stream Load.
    - `insecure_skip_verify` boolean — InsecureSkipVerify disables TLS certificate verification when talking to the backing store over HTTPS. Defaults to false (secure). Set to true ONLY for self-signed development clusters; production deployments should provide trusted certificates via the system CA pool. Cross-driver applicable but currently only the OpenSearch driver (Phase 3) reads this field. Note: this differs from the Qdrant-specific UseTLS below, which *enables* TLS on gRPC connections — InsecureSkipVerify only controls *verification* of an already-TLS connection.
    - `password` string — AES-GCM encrypted
    - `port` integer
    - `scheme` string
    - `use_default_connection` boolean — Postgres
    - `use_tls` boolean
    - `username` string
    - `version` string — Version is the detected server version (e.g., "7.10.1", "16.2", "1.12.6"). Auto-populated by TestConnection on successful connectivity check.
  - `engine_type` 'postgres' | 'elasticsearch' | 'infinity' | 'elasticfaiss' | 'qdrant' | 'milvus' | 'weaviate' | 'doris' | 'sqlite' | 'tencent_vectordb' | 'opensearch', required

## Response `200`

Connection test result (success, version)

- object

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

[API](https://skmtc.net/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.net/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/abce9036def5/schema)