---
title: "Test Connection"
method: POST
path: "/api/connections/test"
tags: ["Connections"]
---

# Test Connection

`POST /api/connections/test`

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-Version` string

## Request body

- TestConnectionRequest
  - `configuration` object, required — Connection configuration to test.
  - `connection_id` string, 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.
  - `type` string, required — The type of connection to test.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

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