Inspectopedia 2025.2 Help

Possible OpenAPI/Swagger specification candidate

Detects YAML files that can be interpreted as a part of OpenAPI/Swagger specification.

Such files do not contain explicit specification attributes, but they are referenced from primary specification files located nearby.

Locating this inspection

By ID

Can be used to locate inspection in e.g. Qodana configuration files, where you can quickly enable or disable it, or adjust its settings.

SwYamlMaybeSpecificationInspection
Via Settings dialog

Path to the inspection settings via IntelliJ Platform IDE Settings dialog, when you need to adjust inspection settings directly from your IDE.

Settings or Preferences | Editor | Inspections | OpenAPI specifications

The following example contains two files located in the same directory. First one is a plain primary specification file. Second is referenced from the first one and thus is suggested to be considered a specification too.

Primary specification file openapi.yaml:

openapi: 3.1.0 components: schemas: CustomSchema: description: Custom schema object properties: foo: $ref: 'common.components.yaml#/components/schemas/CommonSchema'

Specification file candidate common.components.yaml:

components: # 'Mark file as OpenAPI specification' highlighting schemas: CommonSchema: description: Common schema object reused in several specifications

Inspection ID: SwYamlMaybeSpecificationInspection

Suppressing Inspection

You can suppress this inspection by placing the following comment marker before the code fragment where you no longer want messages from this inspection to appear:

//noinspection SwYamlMaybeSpecificationInspection

More detailed instructions as well as other ways and options that you have can be found in the product documentation:

Last modified: 18 September 2025