# Enforced unique IDs across Agents, Teams, and Workflows to prevent collisions

> AgentOS now blocks initialization/resync if duplicate IDs are detected across Agents, Teams, or Workflows. This ensures unambiguous references and prevents hard-to-debug behavior at runtime.

- Published: 2025-12-18
- Author: Agno Team
- Category: Changelog
- Canonical: https://agno-com-nine.vercel.app/articles/enforced-unique-ids-across-agents-teams-and-workflows-to-prevent-collisions
- Markdown: https://agno-com-nine.vercel.app/articles/enforced-unique-ids-across-agents-teams-and-workflows-to-prevent-collisions.md

AgentOS now blocks initialization/resync if duplicate IDs are detected across Agents, Teams, or Workflows. This ensures unambiguous references and prevents hard-to-debug behavior at runtime.

Details:

- Breaking change: initialization will fail on duplicate IDs
- Action: audit and ensure unique IDs before upgrading

Who this is for: Platform owners and multi-team deployments managing large catalogs of agents and workflows.