---
title: "Test an AI provider connection"
method: POST
path: "/v1/admin/ai-connections/{connection_id}/test"
tags: ["Operations"]
---

# Test an AI provider connection

`POST /v1/admin/ai-connections/{connection_id}/test`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/admin/ai-connections/{connection_id}/test`
- Auth: HTTP bearer

Human manage_team + AAL2 only. Performs a bounded authenticated provider probe. A failed candidate probe cannot replace a previously verified active credential.

## Path parameters

- `connection_id` string, required

## Response `200`

Test an AI provider connection response

- object
  - `status` 'verified' | 'failed', required
  - `connection` object, required
    - `id` string, required
    - `provider` 'openai' | 'anthropic' | 'google_gemini', required
    - `label` string, required
    - `status` 'pending' | 'verified' | 'failed' | 'disconnected', required
    - `verified_at` string, nullable, required
    - `last_probe_at` string, nullable, required
    - `last_error_code` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
  - `probe` object, required
    - `checked_at` string, required
    - `latency_ms` number, required

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)