Docs
Discovery

Check a region's control plane and launches

GET
/health/{region}

Answers 200 with "status":"ok" while the control plane that serves the region answers requests and its database answers, and 503 unavailable while it does not. launches says whether new instances start in the region. For uptime monitors, one per region. Running instances depend on neither. No credential needed.

Path Parameters

region*string

A location from GET /v1/locations.

Match^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Length1 <= length <= 63

Header Parameters

X-Correlation-ID?string

An id of your own for this request, or for a group of requests, to find them in our logs and yours. Logged with the request and returned unchanged in X-Correlation-ID. The request id itself is always the API's own, in X-Request-ID.

Match^[A-Za-z0-9._:-]+$
Length1 <= length <= 128

Response Body

The region's control plane answers requests and its database answers, and whether its launches fail.

application/json
  1. response

A control plane's health.

status*string

Always ok; a control plane that is not healthy answers 503.

launches*string

failing while the region's last two launches in the past 30 minutes both failed on the platform's side, ending failed with launch_failed or image_unavailable before they ran; ok otherwise, including when nothing launched. A launch that runs clears it at once.

Example Request
curl -X GET 'https://api.cloud.confidential.ai/health/us-west-1' \  -H 'X-Correlation-ID: rollout-2026-10-22'
Example Response
{  "status": "ok",  "launches": "ok"}