@W-23431001: api-manager operationId + summary cleanup - #194
Open
spezzirriemiliano wants to merge 1 commit into
Open
@W-23431001: api-manager operationId + summary cleanup#194spezzirriemiliano wants to merge 1 commit into
spezzirriemiliano wants to merge 1 commit into
Conversation
Applied cleanup for apis/api-manager: - 118 operationId renames (verbose By-prefixed forms -> resource-focused names) - Summary lines added / normalized (imperative mood, no trailing period) - 7 internal x-origin cross-refs patched to renamed operations - 4 skill files patched (SKILL.md operationId refs + prose backtick mentions): - skills/secure-api - skills/secure-agent - skills/secure-mcp-server - skills/apply-policy-to-api-instance Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Ferticidio
reviewed
Aug 12, 2026
| - type: boolean | ||
| operationId: listOrganizationsEnvironmentsApis | ||
| summary: List APIs | ||
| operationId: listApis |
Contributor
There was a problem hiding this comment.
Let's rename it to listApiInstances
| description: Request body containing the data needed for this operation. | ||
| operationId: createOrganizationsEnvironmentsApis | ||
| summary: Create an API | ||
| operationId: createApi |
| default: false | ||
| operationId: getOrganizationsEnvironmentsApis | ||
| summary: Get an API | ||
| operationId: getApi |
| description: Request body containing the data needed for this operation. | ||
| operationId: updateOrganizationsEnvironmentsApis | ||
| summary: Replace an API | ||
| operationId: updateApi |
| required: true | ||
| description: Request body containing the data needed for this operation. | ||
| operationId: updateOrganizationsEnvironmentsApis | ||
| summary: Replace an API |
Contributor
There was a problem hiding this comment.
It's only an update... not a replacement.
| default: false | ||
| operationId: patchOrganizationsEnvironmentsApis | ||
| summary: Update an API | ||
| operationId: patchApi |
Contributor
There was a problem hiding this comment.
same... patchApiInstance
| description: "Deletes an API\n\nConnected Apps require the following scopes:\n - Manage APIs Configuration\n" | ||
| operationId: deleteOrganizationsEnvironmentsApis | ||
| summary: Delete an API | ||
| operationId: deleteApi |
| description: "Pins an environment API version\n\nConnected Apps require the following scopes:\n - View APIs Configuration\n" | ||
| operationId: updateOrganizationsEnvironmentsApisPin | ||
| summary: Pin an API version | ||
| operationId: pinApi |
| description: Request body containing the data needed for this operation. | ||
| operationId: createOrganizationsEnvironmentsApisUpstreams | ||
| summary: Create an API upstream | ||
| operationId: createApiUpstream |
Contributor
There was a problem hiding this comment.
All this operations (upstreams, policies, tiers)... can be renamed to use "instance" instead of api... you know createInstanceUpstream
Contributor
There was a problem hiding this comment.
This comment does not include ApiGroups... that it's another concept.
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Applied cleanup for apis/api-manager: