Hanzo AI
OpenapiAgent

Delete agent

Removes an agent and every run recorded against it.

DELETE /v1/agent/{ref}

Addresshttps://api.hanzo.ai/v1/agent/{ref}
MethodDELETE
Operationdelete_agent_by_ref
AuthAuthorization: Bearer $HANZO_API_KEY

Removes an agent and every run recorded against it. Answers 204.

Request

1 field.

FieldInTypeRequiredDescription
refpathstringyesRef is the agent's public id (the agent_… handle create and list return) or its org-unique name, from the path.

Response

StatusBodyMeaning
204no content
defaultproblem-detailsrefused

Failure carries the platform error shape — see Errors.

Examples

hanzo agent rm <ref>

Agent API · All Hanzo APIs · Interactive reference

How is this guide?

On this page