unique-tags
Overview
This rule belongs to the openapi-v3-agentic-tools-linting ruleset and states that:
The 'tags' array in the OpenAPI root must contain unique tag names. Duplicate tags create ambiguity in documentation, code generation, and agentic tools. Ensuring tag name uniqueness improves categorization, clarity, and tool-generated outputs.
| Property | Value |
|---|---|
| Enabled | No |
| Maximum Severity | Warning |
| Message | Tags must have unique names. |
| Code | OPENAPI3AGENTICTOOLS_L001 |
| Type | Linting |
| Rule System | Semantic |
| Broad Category | OpenAPI Root Information |
| Products Impacted | Agentic Tools Generation, Code Generation, Developer Experience Portal |
| Tags | code generation AI Agentic tools mcp llm openapi3 openapi semantic linting apimatic tags name unique duplicate |
Suggested Fixes
- Ensure each tag in the 'tags' array has a unique 'name'. Rename or remove duplicates.