---
title: "Liveness check"
method: GET
path: "/tt-liveness"
tags: ["Health"]
---

# Liveness check

`GET /tt-liveness`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/tt-liveness`
- Auth: none required
- TypeScript: <https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/docs/tt-liveness/get.ts> (a function with typed inputs; its response is checked against the schema)

Liveness probe (same as Python tt-liveness). Returns 200 with {"status": "alive", ...system status} when the process can respond. model_ready in the body reflects whether any worker has warmed up. Does not return 503 for model not ready; 500 only on unrecoverable failure.

## Response `200`

Process is alive; body includes status alive and system status (model_ready, workers, queue)

- ReadyResponse
  - `model_ready` boolean: Whether the model is ready for inference
  - `queue_size` integer: Current number of requests in queue
  - `max_queue_size` integer: Maximum queue capacity
  - `device` string: Device type
  - `worker_info` object: Worker status keyed by worker ID (Python-server-compatible format)
  - `runner_in_use` string: Active runner identifier (image services only). Mirrors the Python ModelRunners enum (e.g. 'tt-sdxl-trace', 'tt-sdxl-image-to-image', 'tt-sdxl-edit'). Omitted when the active service does not expose a runner.

## Other responses

- `500`: Unrecoverable failure (e.g. no service configured, exception)

## Changes

- **2026-05-15** `bb6d2b703e7e`: 2 warning, 4 info
  - removed the optional property `workers` from the response with the `200` status
  - removed the optional property `workers` from the response with the `500` status
  - added the optional property `runner_in_use` to the response with the `200` status
  - added the optional property `runner_in_use` to the response with the `500` status
  - …2 more
- **2026-04-03** `d051d35964ca`: 4 warning, 2 info
  - removed the optional property `runner_in_use` from the response with the `200` status
  - removed the optional property `runner_in_use` from the response with the `500` status
  - removed the optional property `worker_info` from the response with the `200` status
  - removed the optional property `worker_info` from the response with the `500` status
  - …2 more

[Operation history](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/changes/tt-liveness/get.md)

---

[API](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon.md) - [All operations](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/llms.txt) - [OpenAPI document](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/revisions/f1176db3fd15?raw)