---
title: "Healthcheck Deep"
method: GET
path: "/v1/health/deep"
tags: ["Health"]
---

# Healthcheck Deep

`GET /v1/health/deep`

Full health check — pings every dependent service with aggressive per-service
timeouts (500ms) so total wall time stays under ~3s even when a service is slow.

Use the ``deep=true`` query parameter for additional data-plane verification
(e.g. reading from MongoDB collections, probing MVS namespaces, inspecting
Celery workers).

## Query parameters

- `deep` boolean
- `metrics` boolean — Include Layer 2 protection metrics

## Response `200`

Successful Response

- HealthCheckResponse — Health check response model.
  - `status` 'OK' | 'DEGRADED', required — Overall health status.
  - `data` HealthServiceStatus, required — Status flags for dependent services.
    - `cache` boolean, required — Cache layer connectivity successful
    - `metadata` boolean, required — Metadata store connectivity successful
    - `vector_store` boolean, required — Vector database connectivity successful
    - `object_storage` boolean, required — Object storage connectivity successful
    - `task_queue` boolean, required — Task queue execution successful
    - `inference` boolean, required — Inference engine health check successful
    - `analytics` boolean, nullable — Analytics backend healthy (optional, None if disabled)
  - `errors` HealthServiceErrors — Optional error messages for dependent services (present when a check fails).
    - `cache` string, nullable — Cache layer error message, if any
    - `metadata` string, nullable — Metadata store error message, if any
    - `vector_store` string, nullable — Vector database error message, if any
    - `object_storage` string, nullable — Object storage error message, if any
    - `task_queue` string, nullable — Task queue error message, if any
    - `inference` string, nullable — Inference engine error message, if any
    - `analytics` string, nullable — Analytics backend error message, if any
  - `meta` object, nullable — Optional metadata such as configured object storage bucket/region/endpoint, API URL, and deployment health details (when deep=True)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/23e05292e326/schema)