Hanzo AIDocs
Sign inAPI key

Delete nodes

Delete one node.

DELETE /v1/ai/nodes/{owner}/{name}

AI → · All API references → · Get started →

Addresshttps://api.hanzo.ai/v1/ai/nodes/{owner}/{name}
MethodDELETE
Operationdelete_ai_nodes_by_owner_by_name
AuthAuthorization: Bearer $HANZO_API_KEY

Delete one node.

Request

2 fields.

FieldInTypeRequiredDescription
ownerpathstringyes
namepathstringyes

Response

StatusBodyMeaning
200Envelope.
401—No credential, or one this service does not accept.
403—A valid credential that may not do this.

200 body — 53 fields.

FieldInTypeAlwaysDescription
databodyany—The operation's own result.
data2bodyany—A second result the operation defines, when it has one.
msgbodystringyesEmpty on success, the reason on failure.
statusbodystringyesOne of ok, error.
data.autoQuerybodyboolean—
data.categorybodystring—
data.cpuSizebodystring—
data.createdTimebodystring—
data.descriptionbodystring—
data.displayNamebodystring—
data.enableRemoteAppbodyboolean—
data.isPermanentbodyboolean—
data.languagebodystring—
data.machineNamebodystring—
data.memSizebodystring—
data.namebodystring—
data.osbodystring—
data.ownerbodystring—
data.patchesbodyPatch[]—
data.patches[].categorybodystring—
data.patches[].expectedStatusbodystring—
data.patches[].installTimebodystring—
data.patches[].messagebodystring—
data.patches[].namebodystring—
data.patches[].sizebodystring—
data.patches[].statusbodystring—
data.patches[].titlebodystring—
data.patches[].urlbodystring—
data.privateIpbodystring—
data.publicIpbodystring—
data.remoteAppsbodyRemoteApp[]—
data.remoteApps[].nobodyinteger—
data.remoteApps[].remoteAppArgsbodystring—
data.remoteApps[].remoteAppDirbodystring—
data.remoteApps[].remoteAppNamebodystring—
data.remotePasswordbodystring—
data.remotePortbodyinteger—
data.remoteProtocolbodystring—
data.remoteUsernamebodystring—
data.servicesbodyService[]—
data.services[].expectedStatusbodystring—
data.services[].messagebodystring—
data.services[].namebodystring—
data.services[].nobodyinteger—
data.services[].pathbodystring—
data.services[].portbodyinteger—
data.services[].processIdbodyinteger—
data.services[].statusbodystring—
data.services[].subStatusbodystring—
data.sizebodystring—
data.tagbodystring—
data.typebodystring—
data.updatedTimebodystring—

Failure carries the platform error shape — see Errors.

Examples

hanzo ai nodes owner rm <owner> <name>
import { Configuration, AiApi } from 'hanzoai';

const api = new AiApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.deleteAiNodesByOwnerByName({ owner: 'owner', name: 'name' });
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import AiApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = AiApi(client).delete_ai_nodes_by_owner_by_name(owner='owner', name='name')
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.AiAPI.DeleteAiNodesByOwnerByName(context.Background()).Execute()
if err != nil {
	return err
}
use hanzo_client::apis::{configuration::Configuration, ai_api};

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

let result = ai_api::delete_ai_nodes_by_owner_by_name(&cfg, Default::default()).await?;
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.AiApi;

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

var result = new AiApi(client).deleteAiNodesByOwnerByName();
curl -X DELETE https://api.hanzo.ai/v1/ai/nodes/<owner>/<name> \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP declares no tool for ai — tools/list on https://api.hanzo.ai/v1/mcp names the products it does reach. Use HTTP or an SDK.

AI API · All Hanzo APIs · Interactive reference

Was this page useful?
PreviousDelete welcomeNextList settings — DELETE /v1/ai/org/settings/list