---
title: "White-box blob round-trip probe"
method: GET
path: "/api/health/blob"
tags: ["health"]
---

# White-box blob round-trip probe

`GET /api/health/blob`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/health/blob`
- Auth: none required

Public, no auth. Sibling of the KV probe: times a PUT then HEAD then DELETE from inside a serverless function, on the actual write path uploads use, so it catches write failure, disk-full, auth drift and tunnel degradation that a plain liveness check cannot. Reports the round trip under the same `kv_ms` field name so one canary parses both probes identically. One fixed path, written then deleted each probe.

## Response `200`

The measurement. Read `degraded`, not the status code.

- HealthProbeResponse: Shared shape for the KV and blob probes — the blob probe reports its round trip under `kv_ms` too, so one canary parses both identically.
  - `ok` boolean, required
  - `kv_ms` integer, required: Measured round-trip milliseconds.
  - `degraded` boolean, required: THE VERDICT. A slow-but-alive dependency is a 200 with this set, not an outage.
  - `threshold_ms` integer
  - `backend` string: The live host the probe actually reached, read from the runtime config rather than hardcoded.
  - `at` string, date-time

## Other responses

- `503`: The blob store threw - not merely slow.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)