---
title: "Test Connection"
method: POST
path: "/api/v1/api-connections/{connection_id}/test"
tags: ["api-connections"]
---

# Test Connection

`POST /api/v1/api-connections/{connection_id}/test`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/api-connections/{connection_id}/test`
- Auth: none declared

## Path parameters

- `connection_id` string, uuid, required

## Request body

- TestConnectionRequest
  - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD'
  - `path` string
  - `headers` object
  - `query` object
  - `body` unknown
  - `idempotency_key` string, required

## Response `200`

Successful Response

- CallRead
  - `id` string, uuid, required
  - `status` 'pending' | 'succeeded' | 'failed', required
  - `status_code` integer, nullable
  - `data` unknown
  - `error` string, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

> 60 revisions in range; 1 not diffed.

- **2026-10-13** `a67e7004da7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/api-connections/:connection_id/test/post.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/29c68bd8ba7b?raw)
