---
title: "Test upstream provider connectivity"
method: POST
path: "/models/test-connection"
tags: ["models"]
---

# Test upstream provider connectivity

`POST /models/test-connection`

Probes the provider's /models endpoint to verify URL and API key without persisting any data. Requires system admin.

## Request body

- InternalApiAdminTestConnectionRequest
  - `api_key` string
  - `base_url` string
  - `provider` string

## Response `200`

OK

- InternalApiAdminTestConnectionResponse
  - `message` string
  - `success` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/voidmind-io/apis/untitled-api.md) · [All operations](https://skmtc.dev/voidmind-io/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voidmind-io/untitled-api/revisions/1405e7d9c155/schema)