Azure/azure-openapi-validator

View on GitHub

Azure Open API Validator

Stars: 53
Forks: 57
Open beginner issues: 0
Indexed issues: 149
Avg merge: 1d 23h
Merged PRs (30d): 2

Dominant language: TypeScript
License: MIT
Last GitHub push: Sep 1, 2026
Latest indexed: Sep 14, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Open All

149 open issues indexed

[NewRule] Response of PUT operation should be a 201 with a provisioningState property Open

investigate

Azure/azure-openapi-validator#37 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Incorrect validation tests Open

bug p1 Sprint-111

Azure/azure-openapi-validator#40 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Linter should categorize errors/warnings in order of severity Open

investigate p1

Azure/azure-openapi-validator#41 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[linter] Evaluating validation rules applicability to data-plane specs Open

Sprint-104

Azure/azure-openapi-validator#42 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 14, 2026
Linter should flag 204 responses that include a model Open

Azure/azure-openapi-validator#43 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Azure validator should include url to more info on automated rules in its messages Open

planned

Azure/azure-openapi-validator#45 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule? Don't repeat enum values, default values or requiredness in the description. Open

p2

Azure/azure-openapi-validator#46 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: operationresults and azureasyncoperation paths should not be documented Open

investigate

Azure/azure-openapi-validator#47 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[NewRule] Get on a resource should not return an array Open

p2

Azure/azure-openapi-validator#48 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
GuidValidation - Guid used at the ***. Usage of Guid is not recommended Open

bug

Azure/azure-openapi-validator#49 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: Every operation MUST have a "default" status code in the "responses" section Open

p1

Azure/azure-openapi-validator#50 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New Rule: ensure the order of parameters specified in the parameters array for every operation Open

Sprint-111

Azure/azure-openapi-validator#51 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Categories (or error levels) of linter rules should not be hard-coded in the rule itself Open

enhancement p1

Azure/azure-openapi-validator#52 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New Rule: Check required properties of a model Open

Azure/azure-openapi-validator#53 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: Property "name"of the "Resource" model SHOULD NOT be required and it must be marked as readOnly Open

p2

Azure/azure-openapi-validator#54 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: PATCHING tags on a Resource Open

Azure/azure-openapi-validator#55 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule or schema update: "examples" property schema Open

Azure/azure-openapi-validator#56 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: operation descriptions should be in third person Open

p2

Azure/azure-openapi-validator#58 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: Every description MUST start with a capital letter and end it with a period ("."). Open

p2

Azure/azure-openapi-validator#59 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Set up nightly builds for the validators Open

enhancement p1

Azure/azure-openapi-validator#66 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
TrackedResourceListByImmediateParent picks up proxy resources Open

investigate planned

Azure/azure-openapi-validator#67 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Remove the OperationIdNounConflictingModelNames. rule Open

p1 planned sdk-rule

Azure/azure-openapi-validator#68 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Rule R2064 reporting LRO for an operation that's not (and applied to Data plane specifications) Open

bug planned Sprint-110

Azure/azure-openapi-validator#69 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
AutoRest linter ignore rules do not work consistently Open

investigate planned

Azure/azure-openapi-validator#70 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Can this repo be named azure-openapi-linter Open

planned

Azure/azure-openapi-validator#71 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Potential incorrect messaging in GetInOperationName Open

bug planned question Sprint-110

Azure/azure-openapi-validator#72 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Potential issue with DescriptionAndTitleMissing Open

bug planned

Azure/azure-openapi-validator#75 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Rule about DefinitionsPropertiesNamesCamelCase firing with odata.type in the property name. Open

Azure/azure-openapi-validator#82 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Update rule categories based on rules documentation Open

planned

Azure/azure-openapi-validator#88 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Group content/media type warnings. Open

Sprint-111

Azure/azure-openapi-validator#89 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
update documentation Open

p2 planned

Azure/azure-openapi-validator#91 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Set up publish jobs for preview packages Open

Azure/azure-openapi-validator#93 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
[Linter][LocationMustHaveXmsMutability] Reports broken path Open

planned sdk-rule

Azure/azure-openapi-validator#97 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
required and default at the same time should trigger at least a warning Open

sdk-rule

Azure/azure-openapi-validator#99 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
consider not recommending flattening when the surrounding type is polymorphic Open

planned sdk-rule

Azure/azure-openapi-validator#102 · 0 comments · 1 reaction · 0 assignees · Indexed Sep 14, 2026
Disallow non-primitive underlying types for enums Open

enhancement sdk-rule

Azure/azure-openapi-validator#107 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: Empty enum should raise a critical error Open

investigate sdk-rule

Azure/azure-openapi-validator#111 · 0 comments · 1 reaction · 0 assignees · Indexed Sep 14, 2026
check enum’s values against x-ms-enum’s values (if present) Open

sdk-rule

Azure/azure-openapi-validator#114 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Validator should show an error if api-version is hard coded Open

sdk-rule

Azure/azure-openapi-validator#120 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Evaluate adding an applicability tag for rules based on a keyword Open

enhancement

Azure/azure-openapi-validator#127 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Add validation rule for cognitive service's authentication pattern Open

planned sdk-rule

Azure/azure-openapi-validator#128 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Overloading with x-ms-paths Open

planned

Azure/azure-openapi-validator#130 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Remove redundant allOf references Open

sdk-rule

Azure/azure-openapi-validator#132 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Dealing with additionalProperties Open

sdk-rule

Azure/azure-openapi-validator#134 · 0 comments · 2 reactions · 0 assignees · Indexed Sep 14, 2026
additionalProperties should not be allowed with x-ms-client-flatten: true extension Open

sdk-rule

Azure/azure-openapi-validator#135 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
New rule: api-version parameter should define an enum with the possible api-versions Open

sdk-rule

Azure/azure-openapi-validator#137 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Warnings "DescriptionAndTitleMissing" and "ParameterDescriptionRequired" should be errors Open

documentation planned Sprint-113

Azure/azure-openapi-validator#140 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Type object should be required when properties are present Open

planned

Azure/azure-openapi-validator#142 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
The linter could check for API version consistency Open

Azure/azure-openapi-validator#145 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026
Arm-Validator does not enforce 200 and 201 on PUT contract Open

investigate

Azure/azure-openapi-validator#147 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 14, 2026

Azure/azure-openapi-validator

Get new issues in your inbox