Hanzo
OpenapiAgents

Deregisters one machine.

Deregisters one machine. Only its owner, or an org admin, may remove it; an unknown id, a cross-org id and a machine owned by someone else all answer the…

DELETE /v1/agents/targets/{id}

Addresshttps://api.hanzo.ai/v1/agents/targets/{id}
MethodDELETE
Operationdelete_agents_targets_by_id
AuthAuthorization: Bearer $HANZO_API_KEY

Deregisters one machine. Only its owner, or an org admin, may remove it; an unknown id, a cross-org id and a machine owned by someone else all answer the same not-found, so a probe learns nothing about what exists.

Request

1 field.

FieldInTypeRequiredDescription
idpathstringyesID is the target to act on, from the path.

Response

StatusBodyMeaning
200targetDeletedok

200 body — 2 fields.

FieldInTypeAlwaysDescription
deletedbodybooleanDeleted is true when the target was removed.
idbodystringID is the target that was removed.

Failure carries the platform error shape — see Errors.

Examples

hanzo agents targets rm <id>

Agents API · All Hanzo APIs · Interactive reference

How is this guide?

On this page