List spaces

Lists the caller org's own spaces.

GET /v1/space/spaces

Space → · All API references → · Get started →

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.

Failure carries the platform error shape — see Errors.

Examples

CLI

SDK

HTTP

MCP

hanzo space spaces get

.ts

.py

.go

.rs

.java

import { 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 reaches space through the space tool, which names its 7 operations with its own verbs — this one among them, under a name only MCP declares. describe explains any of them:

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

Space API · All Hanzo APIs · Interactive reference

Was this page useful?

PreviousList health NextCreate drives