For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
GuidesAPI Reference
Logo
GuidesAPI Reference
  • API Reference
      • GETGet Connection Types
      • GETGet Connection Type
      • POSTConnection Type Parameter Values
      • GETList Connections
      • POSTCreate Connection
      • POSTConnect
      • POSTTest Connection
      • GETGet Connection
      • PUTUpdate Connection
      • DELDelete Connection
      • GETConnection Parameter Values
      • POSTExecute Connection Proxy
      • GETGet Connection Proxy Info
      • GETList Current Org Shared Connections
      • GETList Partner Shared Connections
      • POSTCreate Partner Shared Connection
Log inBook a demo
API ReferenceConnections

Test Connection

POST
https://app.polytomic.com/api/connections/test
POST
/api/connections/test
$curl -X POST https://app.polytomic.com/api/connections/test \
>     -H "Content-Type: application/json" \
>     -d '{
>  "configuration": {
>    "database": "example",
>    "hostname": "postgres.example.com",
>    "password": "password",
>    "port": 5432,
>    "username": "user"
>  },
>  "type": "postgresql"
>}'
Tests a connection configuration. This endpoint is useful for setup flows that want to verify credentials before persisting them. If you provide `connection_id`, Polytomic starts from the saved configuration for that connection and then applies the request's `configuration` values on top. This lets callers test a partial change without resending every existing field. The request does not persist any configuration changes even when validation succeeds.
Was this page helpful?
Previous

Get Connection

Next

Tests a connection configuration.

This endpoint is useful for setup flows that want to verify credentials before persisting them.

If you provide connection_id, Polytomic starts from the saved configuration for that connection and then applies the request’s configuration values on top. This lets callers test a partial change without resending every existing field.

The request does not persist any configuration changes even when validation succeeds.

Headers

X-Polytomic-VersionstringOptional

Request

This endpoint expects an object.
configurationmap from strings to anyRequired
Connection configuration to test.
typestringRequired
The type of connection to test.
connection_idstringOptionalformat: "uuid"
Optional existing connection ID to use as a base for testing. The provided configuration will be merged over the stored configuration for this connection before testing.

Errors

400
Bad Request Error
404
Not Found Error
500
Internal Server Error