Replace kit

Mutes and unmutes names of the org's kit for the caller's own runs, and answers the caller's kit after.

PUT /v1/tool/kit

Tool → · All API references → · Get started →

Address	`https://api.hanzo.ai/v1/tool/kit`
Method	`PUT`
Operation	`put_tool_kit`
Auth	`Authorization: Bearer $HANZO_API_KEY`

Mutes and unmutes names of the org's kit for the caller's own runs, and answers the caller's kit after. The layer only narrows: a name the org's kit does not carry is refused 400, since muting it would say nothing, and unmuting never gives the caller more than an admin put in place. It is the caller's own, so any member may write it. More than 256 names is refused 413.

Request

2 fields, body application/json (required).

Field	In	Type	Required	Description
`mute`	body	string[]	—	Mute takes these out of the caller's runs: a skill (skill_<name>), a server's tool (<server>_<tool>) or a whole server (<server>), each one the org's kit carries.
`unmute`	body	string[]	—	Unmute gives these back, as far as the org's kit carries them.

Response

Status	Body	Meaning
`200`	tool.Kit	ok
`default`	problem-details	refused

200 body — 9 fields.

Field	In	Type	Always	Description
`excess`	body	string[]	—	Excess are servers left out, by id, because a run carries only so many.
`muted`	body	string[]	—	Muted are the names the run's person took out of their own runs — a skill, a server's tool, or a server by its id.
`omitted`	body	string[]	—	Omitted are activated skills left out because a run carries only so many.
`servers`	body	tool.Remote[]	—	Servers are the MCP servers an admin registered and activated tools of, at most KitServers of them.
`servers[].name`	body	string	—	Name is the server's id in the org, which also prefixes its tools on the tool plane, and names it to ToolsRelay.
`servers[].tools`	body	string[]	—	Tools are the tools of it an admin activated, each by the server's own name for it: all a run's harness may call of it.
`skills`	body	tool.SkillDoc[]	—	Skills are the documents of the skills an admin activated, by name.
`skills[].content`	body	string	—	Content is the skill's SKILL.md, verbatim.
`skills[].name`	body	string	—	Name is the skill's bare name, which is also the directory its SKILL.md is written into.

Failure carries the platform error shape — see Errors.

Examples

CLI

SDK

HTTP

MCP

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.

.ts

.py

.go

.rs

.java

import { Configuration, ToolApi } from 'hanzoai';

const api = new ToolApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.putToolKit({ mute: ["<mute>"], unmute: ["<unmute>"] });

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

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = ToolApi(client).put_tool_kit(mute=["<mute>"], unmute=["<unmute>"])

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

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

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

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

let result = tool_api::put_tool_kit(&cfg, Default::default()).await?;

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

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

var result = new ToolApi(client).putToolKit();

curl -X PUT https://api.hanzo.ai/v1/tool/kit \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "mute": [
         "<mute>"
       ],
       "unmute": [
         "<unmute>"
       ]
     }'

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

Tool API · All Hanzo APIs · Interactive reference

Was this page useful?

PreviousReplace activation NextDelete artifacts