Redocly logo
  • Products
  • Build your docs with

    Reunite

    • RealmCombo of Redoc, Revel, and Reef
    • RevelExternal developer showcase
    • RedocAPI reference and mock server
    • ReefInternal service catalog
    • Respect MonitoringAPI monitoring
    • Open source tools:
      Redoc
      Redocly CLI
      Respect
  • Docs
  • Learn
  • Customers
  • Pricing
Search/
2.x (next)
  • 1.x (current)
  • 2.x (next)
  • Redocly CLI
    • Installation
    • Changelog
    • Commands
    • Guides
    • API docs
    • API governance
      • Rules and rulesets
        • Recommended ruleset
        • Minimal ruleset
        • Spec ruleset
        • Ruleset templates
      • Built-in rules
      • Rule configuration
      • Configurable rules
      • Decorators
    • OpenAPI file management
    • Configuration
    • Custom plugins
Last updated 3 weeks ago

Minimal ruleset

The rules contained in the minimal ruleset:

Errors:

  • no-server-trailing-slash
  • no-server-variables-empty-enum
  • no-unresolved-refs
  • struct
  • stepId-unique
  • workflowId-unique

Warnings:

  • configurable rules
  • no-ambiguous-paths
  • no-empty-servers
  • no-enum-type-mismatch
  • no-example-value-and-externalValue
  • no-identical-paths
  • no-invalid-media-type-examples
  • no-path-trailing-slash
  • no-server-example.com
  • no-undefined-server-variable
  • no-unused-components
  • operation-2xx-response
  • operation-operationId-unique
  • operation-operationId-url-safe
  • operation-operationId
  • operation-parameters-unique
  • operation-summary
  • path-declaration-must-exist
  • path-not-include-queryd
  • path-parameters-defined
  • security-defined
  • spec-components-invalid-map-name
  • tag-description

A copy-pastable version of this ruleset is available as a ruleset template.

Was this helpful?

 
Next page

Products

RedocRevelReefRealmReuniteRespect MonitoringRedocly CLIRespect

Explore

PricingProEnterpriseEnterprise PlusCustomersAbout UsCareersContact Sales

Resources

DocsBlogWebinarsWhy RedoclyDocs-like-code

Tech & legal

SecurityTech StackStatusTermsSLADPA

Contact us

GitHub iconLinkedIn iconX iconYouTube icon
Contact Us
© 2024 Redocly Inc. All rights reserved.
Built with 💙 ☕️️ and 🌮. This website runs entirely on Realm.