ruleset.json

{
  "extends": ["spectral:oas"],
  "rules": {
    "no-$ref-siblings": "off",

    "info-contact": "error",
    "info-description": "error",
    "duplicated-entry-in-enum": "error",
    "operation-success-response": "error",
    "operation-operationId-unique": "error",
    "operation-tag-defined": "error",
    "no-eval-in-markdown": "error",
    "no-script-tags-in-markdown": "error",
    "operation-description": "error",
    "operation-operationId": "error",
    "operation-operationId-valid-in-url": "error",
    "operation-tags": "error",
    "path-declarations-must-exist": "error",
    "path-keys-no-trailing-slash": "error",
    "path-not-include-query": "error",
    "typed-enum": "error",
    "oas3-api-servers": "error",
    "oas3-examples-value-or-externalValue": "error",
    "oas3-operation-security-defined": "error",
    "oas3-server-trailing-slash": "error",
    "oas3-unused-component": "error",

    "oas2-api-host": "off",
    "oas2-api-schemes": "off",

    "oas2-anyOf": "error",
    "oas2-discriminator": "error",
    "oas2-host-trailing-slash": "error",
    "oas2-oneOf": "error",
    "oas2-operation-formData-consume-check": "error",
    "oas2-operation-security-defined": "error",
    "oas2-schema": "error",
    "oas2-unused-definition": "error",
    "oas2-valid-media-example": "error",

    "header-required-property": {
      "description": "All headers must explicitly define whether they are required.",
      "message": "Header is missing 'required' property.",
      "severity": "error",
      "given": "$.components.headers.*",
      "then": {
        "field": "required",
        "function": "defined"
      }
    }
  }
}