Space
Where work lives: drives, folders and the files in them.
Also for this capability: API · CLI · SDKs
Where work lives: drives, folders and the files in them.
| Base URL | https://api.hanzo.ai |
| Operations | 7 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Specification
Specification pending — no HIP in hanzoai/hips declares capability: space yet. What this capability serves is below, from the API document; what it is — the store it owns, how it meters, what it publishes — is written as a HIP under HIP-0139.
Four surfaces
| Surface | Reaches this capability as | Coverage |
|---|---|---|
| REST | space at its own prefix | 7 operations |
| CLI | hanzo space … | 7 of 7 |
| SDK | SpaceApi in every published client | 7 methods |
| MCP | — | no tool names it yet — use HTTP or an SDK |
Quickstart
export HANZO_API_KEY=sk-... # console.hanzo.ai → API keysThen the first call — a read that needs nothing but the key. GET /v1/space/health, operation get_space_health:
hanzo space healthimport { Configuration, SpaceApi } from 'hanzoai';
const api = new SpaceApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getSpaceHealth();from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import SpaceApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = SpaceApi(client).get_space_health()cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)
resp, _, err := client.SpaceAPI.GetSpaceHealth(context.Background()).Execute()
if err != nil {
return err
}use hanzo_client::apis::{configuration::Configuration, space_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = space_api::get_space_health(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.SpaceApi;
ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));
var result = new SpaceApi(client).getSpaceHealth();curl https://api.hanzo.ai/v1/space/health \
-H "Authorization: Bearer $HANZO_API_KEY"MCP declares no tool for space — tools/list on https://api.hanzo.ai/v1/mcp names the products it does reach. Use HTTP or an SDK.
Answers 200 with object — ok.
Endpoints
| Endpoint | What it does |
|---|---|
GET /v1/space/{space}/drives/{drive}/files | Lists one folder level of a drive. |
DELETE /v1/space/{space}/drives/{drive} | Removes an EMPTY drive and answers 204. |
GET /v1/space/{space}/drives | Lists a space's drives. |
POST /v1/space/{space}/drives | Makes a new drive in a space and answers 201 with it. |
GET /v1/space/health | Health reports whether this deployment can serve spaces, drives and files. |
GET /v1/space/spaces | Lists the caller org's own spaces. |
POST /v1/space/spaces | Makes a new space for the caller's org and answers 201 with it. |
How is this guide?