Permanently remove an agent from the platform. If the agent is currently active, it is demoted first. For demote-only, use the demote endpoint.

Deleting a supervisor does not affect its sub-agents or their agent-as-tool wrappers.

A sub-agent cannot be deleted while it is still linked to a supervisor. Unlink it and delete its associated agent-as-tool first.