Azure / Azure/autorest

An existed query parameter was removed incorrectly from the resolved output swagger

Open
#5,153 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeSpec
Stars
4.8k
Forks
736
Avg merge
2d 14h
Merged PRs (30d)
1

Description

The resolved swagger file would remove an existed query parameter in correctly when added a new query parameter to the swagger.

Command to run:
```
autorest --v2 --input-file=Microsoft.BlobStorage/stable/2026-12-06/blob.json --output-artifact=swagger-document.json --output-artifact=swagger-document.map --output-file=new --output-folder=/tmp/oad-pmOeuJ
```

Here is a [test commit](https://github.com/raych1/azure-rest-api-specs/pull/121/commits/425d6d3bb184956fc8e1ed74104b6bfb61b7b45a) which added a new query parameter then ended up removing an existed query parameter in the resolved swagger (showed in the screenshot below).
Image

Contributor guide

Open the contributing guide

Research direction

Run the provided autorest command against Microsoft.BlobStorage/stable/2026-12-06/blob.json and compare the resolved swagger output. Read the linked test commit to identify the newly added query parameter and the existing parameter it removes; done means the resolved output preserves both parameters.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.