Short answer: centralize on shared tools, reassign agents to the canonical tool IDs, then safely delete the duplicates.
Recommended cleanup, per ElevenLabs’ current Agents tooling:
Inventory your tools
List all tools in the workspace and group obvious duplicates (same name/endpoint/schema) using GET /v1/convai/tools. (elevenlabs.io)
You can also do this from the Tools management UI introduced June 23, 2025. (elevenlabs.io)
Pick a canonical version per function
For each duplicated function, choose one “source of truth” tool record to keep. If needed, normalize its metadata/schema via PATCH /v1/convai/tools/:tool_id. (elevenlabs.io)
Reassign agents to the canonical tool
Update each agent to reference only the canonical tool via prompt.tool_ids (and keep system tools in prompt.built_in_tools). Use PATCH /v1/convai/agents/:agent_id. (elevenlabs.io)
Verify nothing still depends on the duplicates
Before deleting, check which agents are using a tool with GET /v1/convai/tools/:tool_id/dependent-agents; re-point any stragglers to the canonical tool ID. (elevenlabs.io)
Delete the unused duplicates
Remove them with DELETE /v1/convai/tools/:tool_id. (elevenlabs.io)
Why this is the recommended path
ElevenLabs has decoupled tools from agents; agents should now reference reusable tool IDs. The deprecation guide explicitly recommends migrating to prompt.tool_ids and cleaning up unused standalone tools via the toolbox endpoint. (elevenlabs.io)
Notes and timelines
Legacy prompt.tools was removed on July 23, 2025; use prompt.tool_ids going forward. (elevenlabs.io)
hushed isle
cyan vector