path-declaration-must-exist.md

slug
/docs/cli/rules/path-declaration-must-exist

path-declaration-must-exist

Requires definition of all path template variables.

OAS	Compatibility
2.0	✅
3.0	✅
3.1	✅

API design principles

The path template variables must have a string. This rule is for spec correctness. This rule is not opinionated.

Configuration

Option	Type	Description
severity	string	Possible values: off, warn, error. Default error (in recommended configuration).

An example configuration:

rules:
  path-declaration-must-exist: error

Examples

Given this configuration:

rules:
  path-declaration-must-exist: error

Example of an incorrect path:

paths:
  /customers/{}:
    post:

Example of a correct path:

paths:
  /customers/{id}:
    post:
      parameters:
        - name: id
          in: path
          required: true
          description: The customer's ID.

Related rules

• path-parameters-defined
• path-excludes-patterns
• configurable rules

Resources

• Rule source
• Parameter docs
• Paths docs