List spaces
Lists the caller org's own spaces. Only the caller's: every space is physically named under a per-org prefix and the listing strips that prefix, so…
GET /v1/space/spaces
| Address | https://api.hanzo.ai/v1/space/spaces |
| Method | GET |
| Operation | get_space_spaces |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Lists the caller org's own spaces.
Only the caller's: every space is physically named under a per-org prefix and the listing strips that prefix, so another org's spaces are not in the answer at all. Another org's space is not refused but INVISIBLE, so this cannot be used to learn that a name is taken elsewhere.
Billed per call: the balance is checked BEFORE anything is touched, so an unfunded org is refused with nothing done, and the debit lands only once the work has succeeded.
Request
GET /v1/space/spaces takes no parameters and no body — the credential is the whole request.
Response
| Status | Body | Meaning |
|---|---|---|
200 | space.spaceList | ok |
default | problem-details | refused |
200 body — 4 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
spaces | body | space.spaceItem[] | — | Spaces are the caller org's spaces, oldest first as the store returns them. |
spaces[].createdAt | body | integer (int64) | — | CreatedAt is when the space was made, in unix seconds. |
spaces[].name | body | string | — | Name is the space's name, as the org created it. |
total | body | integer (int64) | — | Total is how many spaces this org has. It equals len(spaces): the listing is not paged, because one bucket per (org, space) keeps an org's count small by… |
Failure carries the platform error shape — see Errors.
Examples
hanzo space spaces getimport { Configuration, SpaceApi } from 'hanzoai';
const api = new SpaceApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getSpaceSpaces();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_spaces()cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)
resp, _, err := client.SpaceAPI.GetSpaceSpaces(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_spaces(&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).getSpaceSpaces();curl https://api.hanzo.ai/v1/space/spaces \
-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.
How is this guide?