---
title: "Probe every vendor/host adapter with a one-result search; report ok / auth / down / timeout / unconfigured (admin, cron)."
method: POST
path: "/v1/op/catalog.sources.health"
tags: ["kernel-ops"]
---

# Probe every vendor/host adapter with a one-result search; report ok / auth / down / timeout / unconfigured (admin, cron).

`POST /v1/op/catalog.sources.health`

## Request

- Base URL: `https://api.geopera.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.geopera.com/v1/op/catalog.sources.health`
- Auth: HTTP bearer

## Headers

- `x-api-key` string, nullable

## Request body

- SourcesHealthInput
  - `hosts` string[], nullable
  - `timeout_seconds` number

## Response `200`

Successful Response

- SourcesHealthOutput
  - `checked_at` string, required
  - `ok` boolean, required
  - `failing` string[], required
  - `results` HostHealth[], required
    - `host` string, required
    - `status` 'ok' | 'auth' | 'down' | 'timeout' | 'unconfigured' | 'error', required
    - `latency_ms` integer, required
    - `features` integer, nullable
    - `detail` string, nullable
  - `credentials` object, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-09-06** `078cbbb15634`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/geopera/apis/geopera-data-platform/changes/v1/op/catalog.sources.health/post.md)

---

[API](https://skmtc.dev/geopera/apis/geopera-data-platform.md) - [All operations](https://skmtc.dev/geopera/apis/geopera-data-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/geopera/apis/geopera-data-platform/revisions/47981e2bd969?raw)