post
https://api.superwise.ai/v1/agents/test-tool-connection
Test a tool connection.
Parameters:
For ToolConfigPostgres:
- type: Literal type indication for Postgres tool (
Postgres). - connection_string: Connection string for the Postgres database.
For ToolConfigMySQL:
- type: Literal type indication for MySQL tool (
MySQL). - connection_string: Connection string for the MySQL database.
For ToolConfigMSSQL:
- type: Literal type indication for MSSQL tool (
MSSQL). - connection_string: Connection string for the MSSQL database.
For ToolConfigOracle:
- type: Literal type indication for Oracle tool (
Oracle). - connection_string: Connection string for the Oracle database.
For ToolConfigBigQuery:
- type: Literal type indication for BigQuery tool (
BigQuery). - project_id: Project ID for BigQuery.
- dataset_id: Dataset ID for BigQuery.
- service_account: Service account information as a dictionary with keys and values as strings.
For ToolConfigPGVector:
- type: Literal type indication for PG Vector tool (
PGVector). - connection_string: Connection string for the PG Vector database.
- table_name: Name of the table in the PG Vector database.
- embedding_model: Configuration of the embedding model to be used.
- provider: Provider of the embedding model (
VertexAIModelGarden). - project_id: Project ID for Vertex AI.
- endpoint_id: Endpoint ID for the model.
- location: Location of the Vertex AI endpoint.
- service_account: Service account information as a dictionary with keys and values as strings.
- provider: Provider of the embedding model (
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Tests the connection for a tool an agent can use. Supported tools are SQL databases (Postgres, MySQL, MSSQL, and Oracle), BigQuery, vector stores (PGVector and Pinecone), OpenAPI tools, MCP servers, and knowledge.
When to use it
Use it to validate connection details and credentials before you add the tool to an agent version.
Required parameters
- Request body: the tool configuration. Its
typeselects the tool, and the remaining fields are that tool's settings, such as aconnection_stringfor a SQL database.
Response
A successful call returns 204 No Content with an empty body.
Related: Test a model connection, Test MCP connectivity, Create an agent version
204Successful Response
422Unprocessable Entity
500Internal Server Error