---
title: "Read per-tool health"
method: GET
path: "/api/v1/tools/health"
---

# Read per-tool health

`GET /api/v1/tools/health`

## Request

- Base URL: `https://prowl.chat`
- URL: `https://prowl.chat/api/v1/tools/health`
- Auth: HTTP bearer

Success rate and latest outcome per tool over a recent window, aggregated across all callers — no per-user data. A tool missing from the reply had no calls in the window, which reads as idle rather than broken.

## Query parameters

- `window_minutes` integer

## Headers

- `authorization` string, nullable

## Cookies

- `prowl_session` string, nullable

## Response `200`

Successful Response

- ToolHealthResponse: Platform health per tool. A tool absent from `tools` had no calls in the window.
  - `window_minutes` integer, required
  - `tools` object, required: Keyed by tool name. Absent means idle, which the UI reads as healthy.

## Other responses

- `401`: Missing, malformed or expired credential.
- `422`: Validation Error

---

[API](https://skmtc.dev/prowl/apis/prowl-rest-api-v1.md) · [All operations](https://skmtc.dev/prowl/apis/prowl-rest-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/prowl/apis/prowl-rest-api-v1/revisions/897e8b30c330?raw)