---
title: "Test the bank's LLM connectivity"
method: POST
path: "/v1/default/banks/{bank_id}/health/llm"
tags: ["Banks"]
---

# Test the bank's LLM connectivity

`POST /v1/default/banks/{bank_id}/health/llm`

## Request

- Base URL: `https://hindsight.vectorize.io` (the document declares no server; this is the origin it was published from)
- URL: `https://hindsight.vectorize.io/v1/default/banks/{bank_id}/health/llm`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vectorize/apis/hindsight-http-api/docs/v1/default/banks/:bank_id/health/llm/post.ts> (a function with typed inputs; its response is checked against the schema)

Probe the LLMs this bank would use for retain / consolidation / reflect with one minimal call each (configs shared across operations are probed once), so you can discover 'not configured / unreachable' instead of a silent stall. Deliberate action (makes a real provider call); not for polling. Returns status only — never the provider, model, endpoint, API key, or raw error. Disable with HINDSIGHT_API_ENABLE_BANK_LLM_HEALTH=false.

## Path parameters

- `bank_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- BankLlmHealthResponse: Per-bank LLM connectivity probe across retain/consolidation/reflect. Operations that share a configuration are probed once. Discloses status only — never the provider, model, endpoint, API key, or raw error.
  - `bank_id` string, required: Bank identifier
  - `operations` LlmOperationHealth[], required: Connectivity status per operation (retain, consolidation, reflect)
    - `operation` 'retain' | 'consolidation' | 'reflect', required: Operation whose LLM was probed
    - `ok` boolean, required: True only when the probe connected successfully
    - `status` 'connected' | 'not_configured' | 'auth_failed' | 'unreachable' | 'timeout', required: 'connected'; 'not_configured' (provider is 'none'); 'auth_failed' (rejected — usually a wrong/expired API key); 'unreachable' (call failed); 'timeout'
    - `latency_ms` number, nullable: Round-trip latency of the probe call

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-04** `4fda98b75f63`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vectorize/apis/hindsight-http-api/changes/v1/default/banks/:bank_id/health/llm/post.md)

---

[API](https://skmtc.dev/vectorize/apis/hindsight-http-api.md) - [All operations](https://skmtc.dev/vectorize/apis/hindsight-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vectorize/apis/hindsight-http-api/revisions/951fd4ce91d1?raw)