---
title: "Get safe AI provider control-plane state"
method: GET
path: "/v1/admin/ai-connections"
tags: ["Operations"]
---

# Get safe AI provider control-plane state

`GET /v1/admin/ai-connections`

## Request

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

Requires a human administrator with manage_team permission and AAL2. Returns provider metadata, server-approved models, and workload bindings, but never a credential, Vault reference, key fragment, or fingerprint.

## Response `200`

Get safe AI provider control-plane state response

- object
  - `schema_version` '1.0', required
  - `mode` 'setup_ready', required
  - `provider_egress_enabled` boolean, required
  - `customer_data_egress_enabled` boolean, required
  - `live_calls_enabled` boolean, required
  - `policies` object, required
    - `evidence_authority` 'LLM output alone has zero verification authority. Only a qualifying immutable receipt recorded by Loppee's controlled automatic or audited-manual authority can satisfy a factor; the caller cannot set the class.', required
    - `customer_support` 'Customer-support AI is draft-only and must be clearly labeled as AI. A human sends every customer-facing reply and human handoff is always available. AI cannot change a business's Verified/Listed class, publication, eligibility, reviews, or ranking.', required
    - `backoffice` 'Back-office AI is read-only. It may search and draft, but cannot mutate records or receive a service-role credential. Connection, rotation, disconnection, and workload changes require a human administrator with recent AAL2 authentication.', required

## Other responses

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