ref(api): use token operationIds + summary for preprod/monitors/sentry_apps/notifications/seer/feedback

betegon · betegon · commit df0769079e60 · 2026-06-17T13:56:27.000+02:00
operationId-&gt;token migration, batch 3 of 3 (35 ops). Sentence -&gt; summary=,
operation_id -&gt; camelCase REST token.

Overrides: startOrganizationIssueAutofix / getOrganizationIssueAutofixState,
submitProjectUserFeedback-&gt;listProjectUserFeedback(structural); unified all
preprod ops to PreprodArtifact casing and fixed the latest-base singleton to
getOrganizationPreprodArtifactSnapshotLatestBase.
diff --git a/src/sentry/feedback/endpoints/project_user_reports.py b/src/sentry/feedback/endpoints/project_user_reports.py
@@ -44,7 +44,8 @@ class ProjectUserReportsEndpoint(ProjectEndpoint):
     authentication_classes = ProjectEndpoint.authentication_classes + (DSNAuthentication,)
 
     @extend_schema(
-        operation_id="List a Project's User Feedback",
+        operation_id="listProjectUserFeedback",
+        summary="List a Project's User Feedback",
         parameters=[CursorQueryParam],
     )
     def get(self, request: Request, project) -> Response:
diff --git a/src/sentry/monitors/endpoints/organization_monitor_checkin_index.py b/src/sentry/monitors/endpoints/organization_monitor_checkin_index.py
@@ -25,7 +25,8 @@ class OrganizationMonitorCheckInIndexEndpoint(MonitorEndpoint, MonitorCheckInMix
     owner = ApiOwner.CRONS
 
     @extend_schema(
-        operation_id="Retrieve Check-Ins for a Monitor",
+        operation_id="listOrganizationMonitorCheckins",
+        summary="Retrieve Check-Ins for a Monitor",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             MonitorParams.MONITOR_ID_OR_SLUG,
diff --git a/src/sentry/monitors/endpoints/organization_monitor_details.py b/src/sentry/monitors/endpoints/organization_monitor_details.py
@@ -35,7 +35,8 @@ class OrganizationMonitorDetailsEndpoint(MonitorEndpoint, MonitorDetailsMixin):
     owner = ApiOwner.CRONS
 
     @extend_schema(
-        operation_id="Retrieve a Monitor",
+        operation_id="getOrganizationMonitor",
+        summary="Retrieve a Monitor",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             MonitorParams.MONITOR_ID_OR_SLUG,
@@ -57,7 +58,8 @@ def get(
         return self.get_monitor(request, project, monitor)
 
     @extend_schema(
-        operation_id="Update a Monitor",
+        operation_id="updateOrganizationMonitor",
+        summary="Update a Monitor",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             MonitorParams.MONITOR_ID_OR_SLUG,
@@ -80,7 +82,8 @@ def put(
         return self.update_monitor(request, project, monitor)
 
     @extend_schema(
-        operation_id="Delete a Monitor or Monitor Environments",
+        operation_id="deleteOrganizationMonitor",
+        summary="Delete a Monitor or Monitor Environments",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             MonitorParams.MONITOR_ID_OR_SLUG,
diff --git a/src/sentry/monitors/endpoints/organization_monitor_index.py b/src/sentry/monitors/endpoints/organization_monitor_index.py
@@ -89,7 +89,8 @@ class OrganizationMonitorIndexEndpoint(OrganizationAlertRuleBaseEndpoint):
     permission_classes = (OrganizationAlertRulePermission,)
 
     @extend_schema(
-        operation_id="Retrieve Monitors for an Organization",
+        operation_id="listOrganizationMonitors",
+        summary="Retrieve Monitors for an Organization",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OrganizationParams.PROJECT,
@@ -270,7 +271,8 @@ def get(
         )
 
     @extend_schema(
-        operation_id="Create a Monitor",
+        operation_id="createOrganizationMonitor",
+        summary="Create a Monitor",
         parameters=[GlobalParams.ORG_ID_OR_SLUG],
         request=MonitorValidator,
         responses={
diff --git a/src/sentry/monitors/endpoints/project_monitor_checkin_index.py b/src/sentry/monitors/endpoints/project_monitor_checkin_index.py
@@ -25,7 +25,8 @@ class ProjectMonitorCheckInIndexEndpoint(ProjectMonitorEndpoint, MonitorCheckInM
     owner = ApiOwner.CRONS
 
     @extend_schema(
-        operation_id="Retrieve Check-Ins for a Monitor by Project",
+        operation_id="listProjectMonitorCheckins",
+        summary="Retrieve Check-Ins for a Monitor by Project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
diff --git a/src/sentry/monitors/endpoints/project_monitor_details.py b/src/sentry/monitors/endpoints/project_monitor_details.py
@@ -35,7 +35,8 @@ class ProjectMonitorDetailsEndpoint(ProjectMonitorEndpoint, MonitorDetailsMixin)
     owner = ApiOwner.CRONS
 
     @extend_schema(
-        operation_id="Retrieve a Monitor for a Project",
+        operation_id="getProjectMonitor",
+        summary="Retrieve a Monitor for a Project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
@@ -55,7 +56,8 @@ def get(self, request: Request, project, monitor) -> Response[MonitorSerializerR
         return self.get_monitor(request, project, monitor)
 
     @extend_schema(
-        operation_id="Update a Monitor for a Project",
+        operation_id="updateProjectMonitor",
+        summary="Update a Monitor for a Project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
@@ -79,7 +81,8 @@ def put(
         return self.update_monitor(request, project, monitor)
 
     @extend_schema(
-        operation_id="Delete a Monitor or Monitor Environments for a Project",
+        operation_id="deleteProjectMonitor",
+        summary="Delete a Monitor or Monitor Environments for a Project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
diff --git a/src/sentry/notifications/api/endpoints/notification_actions_details.py b/src/sentry/notifications/api/endpoints/notification_actions_details.py
@@ -97,7 +97,8 @@ def convert_args(self, request: Request, action_id: str, *args, **kwargs):
         return (parsed_args, parsed_kwargs)
 
     @extend_schema(
-        operation_id="Retrieve a Spike Protection Notification Action",
+        operation_id="getOrganizationNotificationsAction",
+        summary="Retrieve a Spike Protection Notification Action",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             NotificationParams.ACTION_ID,
@@ -122,7 +123,8 @@ def get(
         return Response(body)
 
     @extend_schema(
-        operation_id="Update a Spike Protection Notification Action",
+        operation_id="updateOrganizationNotificationsAction",
+        summary="Update a Spike Protection Notification Action",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             NotificationParams.ACTION_ID,
@@ -171,7 +173,8 @@ def put(
         return Response(put_body, status=status.HTTP_202_ACCEPTED)
 
     @extend_schema(
-        operation_id="Delete a Spike Protection Notification Action",
+        operation_id="deleteOrganizationNotificationsAction",
+        summary="Delete a Spike Protection Notification Action",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             NotificationParams.ACTION_ID,
diff --git a/src/sentry/notifications/api/endpoints/notification_actions_index.py b/src/sentry/notifications/api/endpoints/notification_actions_index.py
@@ -60,7 +60,8 @@ class NotificationActionsIndexEndpoint(OrganizationEndpoint):
     permission_classes = (NotificationActionsPermission,)
 
     @extend_schema(
-        operation_id="List Spike Protection Notifications",
+        operation_id="listOrganizationNotificationsActions",
+        summary="List Spike Protection Notifications",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OrganizationParams.PROJECT,
@@ -121,7 +122,8 @@ def get(
         )
 
     @extend_schema(
-        operation_id="Create a Spike Protection Notification Action",
+        operation_id="createOrganizationNotificationsAction",
+        summary="Create a Spike Protection Notification Action",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
         ],
diff --git a/src/sentry/preprod/api/endpoints/public/organization_preprod_artifact_install_details.py b/src/sentry/preprod/api/endpoints/public/organization_preprod_artifact_install_details.py
@@ -39,7 +39,8 @@ class OrganizationPreprodArtifactPublicInstallDetailsEndpoint(OrganizationEndpoi
     )
 
     @extend_schema(
-        operation_id="Retrieve install info for a given artifact",
+        operation_id="getOrganizationPreprodArtifactInstallDetails",
+        summary="Retrieve install info for a given artifact",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OpenApiParameter(
diff --git a/src/sentry/preprod/api/endpoints/public/organization_preprod_size_analysis.py b/src/sentry/preprod/api/endpoints/public/organization_preprod_size_analysis.py
@@ -70,7 +70,8 @@ class OrganizationPreprodPublicSizeAnalysisEndpoint(OrganizationEndpoint):
     }
 
     @extend_schema(
-        operation_id="Retrieve Size Analysis results for a given artifact",
+        operation_id="getOrganizationPreprodArtifactSizeAnalysis",
+        summary="Retrieve Size Analysis results for a given artifact",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OpenApiParameter(
diff --git a/src/sentry/preprod/api/endpoints/public/project_preprod_build_distribution_latest.py b/src/sentry/preprod/api/endpoints/public/project_preprod_build_distribution_latest.py
@@ -48,7 +48,8 @@ class ProjectPreprodBuildDistributionLatestEndpoint(ProjectEndpoint):
     )
 
     @extend_schema(
-        operation_id="Get the latest installable build for a project",
+        operation_id="getProjectInstallableBuildLatest",
+        summary="Get the latest installable build for a project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
diff --git a/src/sentry/preprod/api/endpoints/public/project_preprod_size_analysis_status_check_rules.py b/src/sentry/preprod/api/endpoints/public/project_preprod_size_analysis_status_check_rules.py
@@ -38,7 +38,8 @@ class ProjectPreprodSizeAnalysisStatusCheckRulesEndpoint(ProjectEndpoint):
     )
 
     @extend_schema(
-        operation_id="Retrieve Size Analysis status check rules for a project",
+        operation_id="getProjectPreprodSizeAnalysisStatusCheckRules",
+        summary="Retrieve Size Analysis status check rules for a project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
diff --git a/src/sentry/preprod/api/endpoints/public/project_preprod_snapshot_status_check_rules.py b/src/sentry/preprod/api/endpoints/public/project_preprod_snapshot_status_check_rules.py
@@ -38,7 +38,8 @@ class ProjectPreprodSnapshotStatusCheckRulesEndpoint(ProjectEndpoint):
     )
 
     @extend_schema(
-        operation_id="Retrieve Snapshot status check rules for a project",
+        operation_id="listProjectPreprodSnapshotsStatusCheckRules",
+        summary="Retrieve Snapshot status check rules for a project",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             GlobalParams.PROJECT_ID_OR_SLUG,
diff --git a/src/sentry/preprod/api/endpoints/snapshots/preprod_artifact_snapshot.py b/src/sentry/preprod/api/endpoints/snapshots/preprod_artifact_snapshot.py
@@ -224,7 +224,8 @@ class OrganizationPreprodSnapshotEndpoint(OrganizationEndpoint):
     permission_classes = (OrganizationReleasePermission,)
 
     @extend_schema(
-        operation_id="Delete a Snapshot",
+        operation_id="deleteOrganizationPreprodArtifactSnapshot",
+        summary="Delete a Snapshot",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OpenApiParameter(
@@ -306,7 +307,8 @@ def delete(
         return Response(status=204)
 
     @extend_schema(
-        operation_id="Retrieve Snapshot details",
+        operation_id="getOrganizationPreprodArtifactSnapshot",
+        summary="Retrieve Snapshot details",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OpenApiParameter(
@@ -657,7 +659,8 @@ class ProjectPreprodSnapshotEndpoint(ProjectEndpoint):
     )
 
     @extend_schema(
-        operation_id="Upload a Snapshot",
+        operation_id="uploadProjectPreprodArtifactSnapshot",
+        summary="Upload a Snapshot",
         parameters=[GlobalParams.ORG_ID_OR_SLUG, GlobalParams.PROJECT_ID_OR_SLUG],
         request=None,
         responses={
diff --git a/src/sentry/preprod/api/endpoints/snapshots/preprod_artifact_snapshot_image_detail.py b/src/sentry/preprod/api/endpoints/snapshots/preprod_artifact_snapshot_image_detail.py
@@ -132,7 +132,8 @@ class OrganizationPreprodSnapshotImageDetailEndpoint(OrganizationEndpoint):
     permission_classes = (OrganizationReleasePermission,)
 
     @extend_schema(
-        operation_id="Retrieve Snapshot image detail",
+        operation_id="getOrganizationPreprodArtifactSnapshotImage",
+        summary="Retrieve Snapshot image detail",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OpenApiParameter(
diff --git a/src/sentry/preprod/api/endpoints/snapshots/preprod_artifact_snapshot_latest_base.py b/src/sentry/preprod/api/endpoints/snapshots/preprod_artifact_snapshot_latest_base.py
@@ -74,7 +74,8 @@ class OrganizationPreprodLatestBaseSnapshotEndpoint(OrganizationEndpoint):
     permission_classes = (OrganizationReleasePermission,)
 
     @extend_schema(
-        operation_id="Retrieve latest base Snapshot",
+        operation_id="getOrganizationPreprodArtifactSnapshotLatestBase",
+        summary="Retrieve latest base Snapshot",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             OpenApiParameter(
diff --git a/src/sentry/seer/endpoints/group_ai_autofix.py b/src/sentry/seer/endpoints/group_ai_autofix.py
@@ -186,7 +186,8 @@ class GroupAutofixEndpoint(GroupAiEndpoint):
     )
 
     @extend_schema(
-        operation_id="Start Seer Issue Fix",
+        operation_id="startOrganizationIssueAutofix",
+        summary="Start Seer Issue Fix",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             IssueParams.ISSUES_OR_GROUPS,
@@ -389,7 +390,8 @@ def post(
             raise PermissionDenied(SEER_PERMISSION_DENIED)
 
     @extend_schema(
-        operation_id="Retrieve Seer Issue Fix State",
+        operation_id="getOrganizationIssueAutofixState",
+        summary="Retrieve Seer Issue Fix State",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             IssueParams.ISSUES_OR_GROUPS,
diff --git a/src/sentry/sentry_apps/api/endpoints/group_external_issues.py b/src/sentry/sentry_apps/api/endpoints/group_external_issues.py
@@ -27,7 +27,8 @@ class GroupExternalIssuesEndpoint(GroupEndpoint):
     }
 
     @extend_schema(
-        operation_id="Retrieve custom integration issue links for the given Sentry issue",
+        operation_id="listOrganizationIssueExternalIssues",
+        summary="Retrieve custom integration issue links for the given Sentry issue",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
             IssueParams.ISSUES_OR_GROUPS,
diff --git a/src/sentry/sentry_apps/api/endpoints/installation_external_issue_details.py b/src/sentry/sentry_apps/api/endpoints/installation_external_issue_details.py
@@ -36,7 +36,8 @@ class SentryAppInstallationExternalIssueDetailsEndpoint(ExternalIssueBaseEndpoin
     }
 
     @extend_schema(
-        operation_id="Delete an External Issue",
+        operation_id="deleteSentryAppInstallationExternalIssue",
+        summary="Delete an External Issue",
         parameters=[SentryAppParams.INSTALLATION_UUID, _EXTERNAL_ISSUE_ID_PARAM],
         responses={
             204: RESPONSE_NO_CONTENT,
diff --git a/src/sentry/sentry_apps/api/endpoints/organization_sentry_apps.py b/src/sentry/sentry_apps/api/endpoints/organization_sentry_apps.py
@@ -30,7 +30,8 @@ class OrganizationSentryAppsEndpoint(ControlSiloOrganizationEndpoint):
     }
 
     @extend_schema(
-        operation_id="Retrieve the custom integrations created by an organization",
+        operation_id="listOrganizationSentryApps",
+        summary="Retrieve the custom integrations created by an organization",
         parameters=[
             GlobalParams.ORG_ID_OR_SLUG,
         ],
diff --git a/src/sentry/sentry_apps/api/endpoints/sentry_app_details.py b/src/sentry/sentry_apps/api/endpoints/sentry_app_details.py
@@ -78,7 +78,8 @@ class SentryAppDetailsEndpoint(SentryAppBaseEndpoint):
     allow_disabled_sentry_app_for_methods = {"DELETE", "PUT", "GET"}
 
     @extend_schema(
-        operation_id="Retrieve a custom integration by ID or slug.",
+        operation_id="getSentryApp",
+        summary="Retrieve a custom integration by ID or slug.",
         parameters=[
             SentryAppParams.SENTRY_APP_ID_OR_SLUG,
         ],
@@ -103,7 +104,8 @@ def get(self, request: Request, sentry_app: SentryApp) -> Response[SentryAppSeri
         )
 
     @extend_schema(
-        operation_id="Update an existing custom integration.",
+        operation_id="updateSentryApp",
+        summary="Update an existing custom integration.",
         parameters=[
             SentryAppParams.SENTRY_APP_ID_OR_SLUG,
         ],
@@ -226,7 +228,8 @@ def put(
         return Response(as_validation_errors(serializer), status=400)
 
     @extend_schema(
-        operation_id="Delete a custom integration.",
+        operation_id="deleteSentryApp",
+        summary="Delete a custom integration.",
         parameters=[
             SentryAppParams.SENTRY_APP_ID_OR_SLUG,
         ],

Original file line number	Diff line number	Diff line change
`@@ -44,7 +44,8 @@ class ProjectUserReportsEndpoint(ProjectEndpoint):`
`44`	`44`	`authentication_classes = ProjectEndpoint.authentication_classes + (DSNAuthentication,)`
`45`	`45`
`46`	`46`	`@extend_schema(`
`47`		`- operation_id="List a Project's User Feedback",`
	`47`	`+ operation_id="listProjectUserFeedback",`
	`48`	`+ summary="List a Project's User Feedback",`
`48`	`49`	`parameters=[CursorQueryParam],`
`49`	`50`	`)`
`50`	`51`	`def get(self, request: Request, project) -> Response:`
Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,8 @@ class OrganizationPreprodArtifactPublicInstallDetailsEndpoint(OrganizationEndpoi`
`39`	`39`	`)`
`40`	`40`
`41`	`41`	`@extend_schema(`
`42`		`- operation_id="Retrieve install info for a given artifact",`
	`42`	`+ operation_id="getOrganizationPreprodArtifactInstallDetails",`
	`43`	`+ summary="Retrieve install info for a given artifact",`
`43`	`44`	`parameters=[`
`44`	`45`	`GlobalParams.ORG_ID_OR_SLUG,`
`45`	`46`	`OpenApiParameter(`
Original file line number	Diff line number	Diff line change
`@@ -70,7 +70,8 @@ class OrganizationPreprodPublicSizeAnalysisEndpoint(OrganizationEndpoint):`
`70`	`70`	`}`
`71`	`71`
`72`	`72`	`@extend_schema(`
`73`		`- operation_id="Retrieve Size Analysis results for a given artifact",`
	`73`	`+ operation_id="getOrganizationPreprodArtifactSizeAnalysis",`
	`74`	`+ summary="Retrieve Size Analysis results for a given artifact",`
`74`	`75`	`parameters=[`
`75`	`76`	`GlobalParams.ORG_ID_OR_SLUG,`
`76`	`77`	`OpenApiParameter(`