List statistics

Returns the transactor's live sessions for the space the caller's credential names — the endpoint the front's space switcher and server panel poll on the transactor base.

GET /v1/team/transactor/statistics

Team → · All API references → · Get started →

Address	`https://api.hanzo.ai/v1/team/transactor/statistics`
Method	`GET`
Operation	`get_team_transactor_statistics`
Auth	`Authorization: Bearer $HANZO_API_KEY`

Returns the transactor's live sessions for the space the caller's credential names — the endpoint the front's space switcher and server panel poll on the transactor base. token carries the same two lanes the socket's path segment does: a space UUID names the space and is authorized against the membership rows, an HS256 space token names it in its signed claims. activeSessions carries ONLY that one space, never another tenant's sessions. An unverifiable credential, or one the caller is no member under, is 401.

Request

1 field.

Field	In	Type	Required	Description
`token`	query	string	—	Token is the space token minted by selectWorkspace.

Response

Status	Body	Meaning
`200`	team.statsOut	ok
`default`	problem-details	refused

200 body — 6 fields.

Field	In	Type	Always	Description
`admin`	body	boolean	—	Admin is the upstream service's server-panel flag, always false here.
`metrics`	body	object	—	Metrics is the upstream transactor's metrics block.
`statistics`	body	team.statsSessions	—
`statistics.activeSessions`	body	object	—	ActiveSessions maps a space uuid to its connected sessions.
`statistics.activeSessions.*`	body	team.statsUser[]	—
`statistics.activeSessions.*[].userId`	body	string	—	UserID is the account the session is authenticated as.

Failure carries the platform error shape — see Errors.

Examples

CLI

SDK

HTTP

MCP

hanzo team transactor statistics

.ts

.py

.go

.rs

.java

import { Configuration, TeamApi } from 'hanzoai';

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

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

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = TeamApi(client).get_team_transactor_statistics()

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

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

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

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

let result = team_api::get_team_transactor_statistics(&cfg, Default::default()).await?;

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

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

var result = new TeamApi(client).getTeamTransactorStatistics();

curl https://api.hanzo.ai/v1/team/transactor/statistics \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP reaches team through the team tool, which names its 33 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_team_account_providers"
         }
       }
     }'

Team API · All Hanzo APIs · Interactive reference

Was this page useful?

PreviousGet transactor NextUpdate docs