feat: add openapi snip command to remove operations from specs #1699
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
Add new `speakeasy openapi snip` command that removes specified operations
from OpenAPI specifications and cleans up unused components.
Features:
- Remove mode: removes specified operations (default)
- Keep mode: keeps only specified operations, removes everything else
- Supports operation selection by operationId or path:method format
- Automatically cleans up unused components after operation removal
- Outputs to stdout (for piping) or file
Examples:
- speakeasy openapi snip --schema spec.yaml --operationId deleteUser
- speakeasy openapi snip --schema spec.yaml --operation /users/{id}:DELETE
- speakeasy openapi snip --keep --schema spec.yaml --operation /users:GET
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Update all command examples in the snip help documentation from `speakeasy openapi transform snip` to `speakeasy openapi snip` to reflect the correct command path. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
The yamlOut parameter was not being used in the Snip function. The marshaller.Marshal() function from the openapi package automatically handles output format detection, making this parameter unnecessary. Changes: - Removed yamlOut parameter from Snip() function signature - Updated cmd/openapi/snip.go to not pass yamlOut argument - Updated all test calls to remove the yamlOut parameter 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
mfbx9da4
approved these changes
Nov 10, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Add new
speakeasy openapi snipcommand that removes specified operations from OpenAPI specifications and cleans up unused components.Features:
Examples:
🤖 Generated with Claude Code
Resolves Bug: Duplicate example in Retry-After header after filtering
https://linear.app/speakeasy/issue/GEN-2002/bug-duplicate-example-in-retry-after-header-after-filtering