Skip to main content



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

A Schema Object in an OpenAPI 3.0.x document can be marked as write-only using the writeOnly attribute only if it is defining a schema property i.e. writeOnly is relevant only for Schema Object properties schema definitions.

Maximum SeverityWarning
MessageSchema is marked as write-only but is not a property schema definition.
Rule SystemSemantic
Broad CategorySchemas
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic linting write only property schema

Suggested Fixes

  • You can mark a property as write-only but not a root-level schema nor one nested directly under parameters, request body, responses, etc.
  • Ensure that writeOnly attribute is being used in the Schema Object that is defining a property from the properties object.

For More Information