---
title: "Check Executor Health"
method: POST
path: "/validator/{validator_hotkey}/executor-health-check"
tags: ["General APIs with JWT"]
---

# Check Executor Health

`POST /validator/{validator_hotkey}/executor-health-check`

Endpoint to run health check on a node.

The check creates a temporary GPU container on the executor, so it must never run on a machine
a customer is actively using. It is skipped (and passed) when the executor has an active
customer rental — signalled by the validator's ``rental_in_progress`` flag, confirmed by a fresh
DB check, or detected after the fact if a rental landed mid-check. See services/rental_gate.py.

## Request body

- ExecutorHealthCheckRequest
  - `miner_address` string, required
  - `miner_port` integer, required
  - `miner_hotkey` string, required
  - `container_port` integer, required
  - `executor_id` string, nullable
  - `rental_in_progress` boolean
  - `gpu_uuids` string[]
  - `cpu_count` integer, nullable

## Response `200`

Successful Response

- ExecutorHealthCheckResponse
  - `success` boolean, required
  - `error` string, nullable
  - `details` object, nullable
  - `reason_code` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/57db0a9348db/schema)