Skip to main content



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

A Schema Object property defined in an OpenAPI 3.0.x document under the properties property, cannot be marked as both read-only as well as write-only i.e. the property definition must not set both readOnly and writeOnly as true.

Maximum SeverityError
MessageProperty is marked as read-only as well as write-only.
Rule SystemSemantic
Broad CategorySchemas
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic validation read only write only property schema

Suggested Fixes

  • Either set value of property readOnly or that of writeOnly as false.
  • Remove either the property readOnly or writeOnly from the Schema Object definition of the property.

For More Information