---
title: "Run a quick connection or full Agent compatibility test"
method: POST
path: "/v1/providers/{connection}/test"
---

# Run a quick connection or full Agent compatibility test

`POST /v1/providers/{connection}/test`

## Request

- Base URL: `https://modelpilot.andycywu.cc`
- URL: `https://modelpilot.andycywu.cc/v1/providers/{connection}/test`
- Auth: HTTP bearer

## Path parameters

- `connection` string, required

## Request body

- ProviderTestRequest
  - `mode` 'connection' | 'conformance': Conformance adds a synthetic tool call and tool-result turn and can make up to three provider requests.

## Response `200`

All applicable checks passed

- ProviderTestResult
  - `id` string, uuid, required
  - `object` 'provider.connection_test', required
  - `mode` 'connection' | 'conformance', required
  - `provider` string, required
  - `connection_id` string
  - `target_id` string, required
  - `upstream_model` string, required
  - `status` 'connected' | 'failed', required
  - `checks` ProviderTestCheck[], required
    - `name` 'chat' | 'tool_call' | 'tool_result', required
    - `status` 'passed' | 'failed' | 'skipped', required
    - `latency_ms` number, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `estimated_cost` number, required
    - `error_code` string
    - `error_message` string
    - `schema_adjustments` string[]
  - `latency_ms` number, required
  - `input_tokens` integer, required
  - `output_tokens` integer, required
  - `estimated_cost` number, required
  - `error_code` string
  - `error_message` string
  - `created_at` string, date-time, required

## Other responses

- `400`: Malformed request or invalid mode
- `429`: One-minute connection test throttle
- `502`: One or more provider checks failed

---

[API](https://skmtc.dev/andycywu/apis/modelpilot-task-api.md) · [All operations](https://skmtc.dev/andycywu/apis/modelpilot-task-api/llms.txt) · [OpenAPI document](https://skmtc.dev/andycywu/apis/modelpilot-task-api/revisions/5af2d641c7e1?raw)