docs: fix swagger documentation for DELETE port share endpoint #18426
+67
−22
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
The DELETE endpoint for workspace agent port shares had incorrect Swagger documentation that duplicated the GET endpoint's summary and ID. This fixes the documentation to properly describe the DELETE operation. Co-authored-by: matifali <10648092+matifali@users.noreply.github.com>
This updates the generated API documentation to reflect the corrected Swagger annotations for the DELETE port share endpoint. Co-authored-by: matifali <10648092+matifali@users.noreply.github.com>
This updates all the markdown API documentation files to reflect the corrected Swagger annotations for the DELETE port share endpoint. The documentation now properly shows separate sections for GET and DELETE operations with correct descriptions. Co-authored-by: matifali <10648092+matifali@users.noreply.github.com>
|
Try running |
matifali
approved these changes
Jun 18, 2025
johnstcn
approved these changes
Jun 18, 2025
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Fixes incorrect Swagger documentation for the DELETE workspace agent port share endpoint.
Problem
The DELETE endpoint at
/workspaces/{workspace}/port-sharehad duplicate Swagger documentation from the GET endpoint:@Summary Get workspace agent port shares(should be "Delete...")@ID get-workspace-agent-port-shares(should be "delete-...")This caused confusing API documentation where both endpoints appeared to have the same purpose.
Solution
Updated the DELETE endpoint's Swagger annotations to properly describe the delete operation:
@Summary Delete workspace agent port share@ID delete-workspace-agent-port-shareTesting