---
title: "Test an AI provider connection."
method: POST
path: "/v1/ai/test"
tags: ["AI"]
---

# Test an AI provider connection.

`POST /v1/ai/test`

## Request

- Base URL: `https://127.0.0.1/api`
- URL: `https://127.0.0.1/api/v1/ai/test`
- Auth: none declared. Required headers: `X-AI-Base-Url`, `X-AI-Model`

## Headers

- `X-AI-Base-Url` string, required
- `X-AI-Api-Key` string
- `X-AI-Model` string, required

## Response `200`

- object
  - `data` ResAITestConnection
    - `endpoint` string
    - `latency_ms` integer
    - `model` string
    - `ok` boolean
  - `status` string

## Other responses

- `400`: Fail due to resource not exists
- `401`: Server understand request but refuse to authorize it
- `502`: Unexpected error occurred
- `503`: Unexpected error occurred

## Changes

- **2026-09-16** `15ae2821b57b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/improwised/apis/improwised-technologies-pvt-ltd-jovvix-api/changes/v1/ai/test/post.md)

---

[API](https://skmtc.dev/improwised/apis/improwised-technologies-pvt-ltd-jovvix-api.md) - [All operations](https://skmtc.dev/improwised/apis/improwised-technologies-pvt-ltd-jovvix-api/llms.txt) - [OpenAPI document](https://skmtc.dev/improwised/apis/improwised-technologies-pvt-ltd-jovvix-api/revisions/15ae2821b57b?raw)