Delete agent
Agents
Delete agent
Permanently delete an agent by ID.
DELETE
Delete agent
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.
Last modified on June 18, 2026