---
title: "Connect and verify an AI provider"
method: POST
path: "/v1/admin/ai-connections"
tags: ["Operations"]
---

# Connect and verify an AI provider

`POST /v1/admin/ai-connections`

## Request

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

Human manage_team + AAL2 only. The write-only credential is probed server-side and stored through the Vault boundary; it is never returned. Connecting a provider does not enable any workload.

## Request body

- object
  - `provider` 'google_gemini', required
  - `api_key` string, required

## Response `200`

Connect and verify an AI provider response

- object
  - `status` 'verified', 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

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `413`: 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)