feat: add openai schema tag for our versioned APIs

Add openai schema tag for our new versioned APIs for distinguishment, So that we can filter out the /auhoring-api/schema/ on the basis of tags and create/update our sdk.

Author: Faraz32123

cms/djangoapps/contentstore/rest_api/v1/views/xblock.py

@@ -33,6 +33,7 @@
 import logging
 
 from django.http import JsonResponse
+from drf_spectacular.utils import extend_schema
 from edx_rest_framework_extensions.auth.jwt.authentication import JwtAuthentication
 from edx_rest_framework_extensions.auth.session.authentication import SessionAuthenticationAllowInactiveUser
 from opaque_keys import InvalidKeyError
@@ -88,6 +89,7 @@ def _apply_minimal_view(response):
     return JsonResponse({k: v for k, v in body.items() if k in _MINIMAL_VIEW_FIELDS})
 
 
+@extend_schema(tags=["openedx-platform-sdk"])
 class XblockViewSet(StandardizedErrorMixin, viewsets.ViewSet):
     """
     ViewSet for xblock CRUD operations (v1 — ADR 0028).

cms/djangoapps/contentstore/rest_api/v3/views/authoring_grading.py

@@ -81,6 +81,7 @@
 )
 
 
+@extend_schema(tags=["openedx-platform-sdk"])
 class AuthoringGradingViewSet(StandardizedErrorMixin, viewsets.ViewSet):
     """
     ViewSet for course grading settings (v3). Registered via DefaultRouter

cms/djangoapps/contentstore/rest_api/v3/views/course_details.py

@@ -128,6 +128,7 @@ def _apply_view_preset(data, view_preset):
     return {key: value for key, value in data.items() if key in _MINIMAL_VIEW_FIELDS}
 
 
+@extend_schema(tags=["openedx-platform-sdk"])
 class CourseDetailsViewSet(StandardizedErrorMixin, viewsets.ViewSet):
     """
     ViewSet for course details (v3). Registered via DefaultRouter (basename ``course_details``).

cms/djangoapps/contentstore/rest_api/v3/views/home.py

@@ -28,6 +28,7 @@
 
 import edx_api_doc_tools as apidocs
 from django.conf import settings
+from drf_spectacular.utils import extend_schema
 from edx_rest_framework_extensions.auth.jwt.authentication import JwtAuthentication
 from edx_rest_framework_extensions.auth.session.authentication import SessionAuthenticationAllowInactiveUser
 from organizations import api as org_api
@@ -47,6 +48,7 @@
 from openedx.core.lib.api.mixins import StandardizedErrorMixin
 
 
+@extend_schema(tags=["openedx-platform-sdk"])
 class HomeViewSet(StandardizedErrorMixin, viewsets.ViewSet):
     """
     ViewSet for the Studio home page. Registered via DefaultRouter (basename ``home``).

cms/djangoapps/contentstore/rest_api/v4/views/home.py

@@ -99,6 +99,7 @@ def _maybe_set_legacy_order_deprecation_header(
     return response
 
 
+@extend_schema(tags=["openedx-platform-sdk"])
 class HomeCoursesViewSet(StandardizedErrorMixin, viewsets.ViewSet):
     """
     ViewSet for course listing (v4). Registered via DefaultRouter (basename ``home-courses``).

cms/lib/spectacular.py

@@ -5,13 +5,11 @@
 
 def cms_api_filter(endpoints):
     """
-    At the moment, we are only enabling drf-spectacular for the CMS API.
-    Filter out endpoints that are not part of the CMS API.
+    Pre-processing hook: keep only contentstore versioned endpoints and select
+    course-level endpoints.
     """
     filtered = []
-    CMS_PATH_PATTERN = re.compile(
-        r"^/api/contentstore/v0/(xblock|videos|video_transcripts|file_assets|youtube_transcripts)"
-    )
+    CMS_PATH_PATTERN = re.compile(r"^/api/contentstore/v\d+/")
 
     for path, path_regex, method, callback in endpoints:
         if CMS_PATH_PATTERN.match(path) or (

openedx/core/djangoapps/enrollments/v2/views.py

@@ -196,6 +196,7 @@ def _is_minimal_view_requested(request) -> bool:
 # EnrollmentViewSet — consolidates list / create / unenroll / allowed
 # ===========================================================================
 @can_disable_rate_limit
+@extend_schema(tags=["openedx-platform-sdk"])
 class EnrollmentViewSet(StandardizedErrorMixin, viewsets.ViewSet, ApiKeyPermissionMixIn):
     """
     Canonical ViewSet for the v2 Enrollment API.
@@ -423,6 +424,7 @@ def allowed(self, request):
 # ===========================================================================
 # Kept as a standalone APIView because the {username},{course_id} URL form
 # (comma-separated, both optional) is not expressible via DefaultRouter.
+@extend_schema(tags=["openedx-platform-sdk"])
 class EnrollmentRetrieveView(StandardizedErrorMixin, ApiKeyPermissionMixIn, APIView):
     """GET enrollment for a course (and optionally a named user)."""
 
@@ -501,6 +503,7 @@ def get(self, request, course_id=None, username=None):
 # ===========================================================================
 # UserRolesView — GET /roles/  (singleton list endpoint for the current user)
 # ===========================================================================
+@extend_schema(tags=["openedx-platform-sdk"])
 class UserRolesView(StandardizedErrorMixin, APIView):
     """List the current user's course-level roles."""
 
@@ -574,6 +577,7 @@ def get(self, request):
 # ===========================================================================
 # CourseEnrollmentDetailView — GET /course/{course_id}  (public, no auth)
 # ===========================================================================
+@extend_schema(tags=["openedx-platform-sdk"])
 class CourseEnrollmentDetailView(StandardizedErrorMixin, APIView):
     """Get enrollment information about a particular course."""
 
@@ -624,6 +628,7 @@ def get(self, request, course_id=None):
 # EnrollmentsAdminListView — GET /enrollments/  (admin paginated list)
 # ===========================================================================
 @extend_schema(
+    tags=["openedx-platform-sdk"],
     summary="List all course enrollments (admin-only, paginated)",
     description=(
         "Admin-only paginated list of CourseEnrollment records, optionally filtered by "