Skip to main content

unique-schema-title

Overview

This rule belongs to the openapi-v3-apimatic-linting ruleset and states that:

Duplicate schema titles have been found, which can lead to confusion and potential conflicts. Each schema within the API specification must have a unique title.

PropertyValue
EnabledYes
Maximum SeverityError
MessageDuplicate schema title found.
CodeOPENAPI3APIMATIC_L663
TypeLinting
Rule SystemSemantic
Broad CategoryOpenAPI Schemas
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi apimatic semantic linting unique schema title duplicate name

Suggested Fixes

  • Remove duplicate schemas.
  • If your schema entry is an alias definition, ensure that the alias resolves into a concrete schema definition.
  • Assign a unique name to the conflicting schemas and update references accordingly.
  • Schemas are compared in a case-sensitive manner.

For More Information