---
title: "Test Connection"
method: POST
path: "/api/v1/integrations/test-connection"
tags: ["integrations"]
---

# Test Connection

`POST /api/v1/integrations/test-connection`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/integrations/test-connection`
- Auth: none declared

Test connection to an agent endpoint by POSTing the same canary shape
real screening dispatch uses, and verify it responds with valid JSON.

PROD-DEFECT-1 — the probe now mirrors `arena._call_agent_endpoint`
exactly: same HTTP method (POST), same SSRF-pinned dispatch, same
badge_native wire shape. A customer who followed the docs and built a
POST-only handler no longer gets a false-negative 405 here.

## Query parameters

- `endpoint` string, required: The endpoint URL to test
- `framework` string: The framework type. One of the known frameworks (langchain, crewai, …) or a generic label (custom/generic/http/endpoint) for a framework-agnostic endpoint test.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)