---
title: "KV connectivity diagnostic"
method: GET
path: "/v1/admin/kv-check"
tags: ["admin"]
---

# KV connectivity diagnostic

`GET /v1/admin/kv-check`

## Request

- Base URL: `https://modelglass-api.vercel.app`
- URL: `https://modelglass-api.vercel.app/v1/admin/kv-check`
- Auth: HTTP bearer

Internal ops diagnostic — confirms the Upstash KV env vars are set and a live read/write round-trip works. Not part of the public API; documented here only so the spec matches the router exactly.

## Response `200`

KV diagnostic result.

- object
  - `ok` true, required
  - `data` object, required
    - `kv_url_set` boolean
    - `kv_token_set` boolean
    - `kv_ping` 'ok' | 'failed' | 'not_configured'
    - `test_write` 'ok' | 'failed' | 'not_configured'
  - `meta` ResponseMeta, required
    - `artifact_version` integer, required
    - `built_at` string, date-time, required
    - `count` integer: Item count when `data` is a collection.

## Other responses

- `401`: Invalid or missing admin secret (UNAUTHORIZED).

---

[API](https://skmtc.dev/modelglass/apis/modelglass-read-api.md) · [All operations](https://skmtc.dev/modelglass/apis/modelglass-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelglass/apis/modelglass-read-api/revisions/5948ffa60462?raw)