List health

Reports blueprint liveness and echoes the compute rate card in force.

GET /v1/blueprint/health

Blueprint → · All API references → · Get started →

Address	`https://api.hanzo.ai/v1/blueprint/health`
Method	`GET`
Operation	`get_blueprint_health`
Auth	`Authorization: Bearer $HANZO_API_KEY`

Reports blueprint liveness and echoes the compute rate card in force.

The rate card is the one the estimator actually applies after the operator env overlay, so an operator can confirm a tuned knob took effect rather than inferring it from a price. Not JWT-gated — a liveness probe must be reachable — and it always answers 200 while the subsystem is mounted.

Request

GET /v1/blueprint/health takes no parameters and no body — the credential is the whole request.

Response

Status	Body	Meaning
`200`	blueprint.blueprintHealth	ok
`default`	problem-details	refused

200 body — 7 fields.

Field	In	Type	Always	Description
`blueprints`	body	integer (int64)	—	Blueprints is how many blueprints this build has embedded and priced.
`rateCard`	body	blueprint.RateCard	—
`rateCard.basis`	body	string	—	Basis names where the rates come from, so a published price can be explained rather than merely asserted.
`rateCard.microUsdPerGbHour`	body	integer (int64)	—	MicroUSDPerGBHour is the price of one GiB of memory for one hour, in millionths of a US dollar.
`rateCard.microUsdPerVcpuHour`	body	integer (int64)	—	MicroUSDPerVCPUHour is the price of one vCPU for one hour, in millionths of a US dollar.
`service`	body	string	—	Service names the subsystem answering — always "blueprint".
`status`	body	string	—	Status is "ok"; the route answers 200 whenever the subsystem is mounted.

Failure carries the platform error shape — see Errors.

Examples

CLI

SDK

HTTP

MCP

hanzo blueprint health

.ts

.py

.go

.rs

.java

import { Configuration, BlueprintApi } from 'hanzoai';

const api = new BlueprintApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getBlueprintHealth();

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import BlueprintApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = BlueprintApi(client).get_blueprint_health()

cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.BlueprintAPI.GetBlueprintHealth(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_client::apis::{configuration::Configuration, blueprint_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = blueprint_api::get_blueprint_health(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.BlueprintApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new BlueprintApi(client).getBlueprintHealth();

curl https://api.hanzo.ai/v1/blueprint/health \
  -H "Authorization: Bearer $HANZO_API_KEY"

Tool blueprint, op get_blueprint_health — POST the JSON-RPC envelope to https://api.hanzo.ai/v1/mcp.

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "blueprint",
         "arguments": {
           "op": "get_blueprint_health",
           "input": {}
         }
       }
     }'

Blueprint API · All Hanzo APIs · Interactive reference

Was this page useful?

PreviousCreate void NextList sbom