Returns the caller org's bot members — the org's agents projected as the…
Returns the caller org's bot members — the org's agents projected as the workspace Employees they become, each with the member account uuid and Person…
GET /v1/team/bots
| Address | https://api.hanzo.ai/v1/team/bots |
| Method | GET |
| Operation | get_team_bots |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Returns the caller org's bot members — the org's agents projected as the workspace Employees they become, each with the member account uuid and Person reference the roster addresses it by. An agents subsystem that is not mounted answers an empty list, never an error.
Request
GET /v1/team/bots takes no parameters and no body — the credential is the whole request.
Response
| Status | Body | Meaning |
|---|---|---|
200 | botRoster | ok |
200 body — 6 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
bots | body | botMember[] | — | Bots is every agent of the caller's org, projected as a workspace member. |
bots[].active | body | boolean | — | Active is whether the agent projects as a LIVE workspace member, derived from its registry status: empty, "active" and "ready" are live, anything else… |
bots[].id | body | string | — | the agent id |
bots[].name | body | string | — | display name |
bots[].personRef | body | string | — | the projected Person _id |
bots[].userId | body | string | — | derived member account uuid (personUuid) |
Failure carries the platform error shape — see Errors.
Examples
hanzo team bots getimport { Configuration, TeamApi } from 'hanzoai';
const api = new TeamApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getTeamBots();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_bots()cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.TeamAPI.GetTeamBots(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::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_bots(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.TeamApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new TeamApi(client).getTeamBots();curl https://api.hanzo.ai/v1/team/bots \
-H "Authorization: Bearer $HANZO_API_KEY"The door reaches team through the team tool, which names its 18 operations with its own verbs — this one among them, under a name only the door 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": "get_collaborator"
}
}
}'How is this guide?