squash!: Add missing schema docs for OrgsAPIView

Author: rodmgwgu

openedx_authz/rest_api/v1/views.py

@@ -10,6 +10,7 @@
 import edx_api_doc_tools as apidocs
 from django.contrib.auth import get_user_model
 from django.http import HttpRequest
+from edx_api_doc_tools import schema_for
 from organizations.models import Organization
 from rest_framework import filters, generics, status
 from rest_framework.response import Response
@@ -454,6 +455,18 @@ def get(self, request: HttpRequest) -> Response:
 
 
 @view_auth_classes()
+@schema_for(
+    "get",
+    parameters=[
+        apidocs.query_parameter("search", str, description="Filter orgs by name or short_name"),
+        apidocs.query_parameter("page", int, description="Page number for pagination"),
+        apidocs.query_parameter("page_size", int, description="Number of items per page"),
+    ],
+    responses={
+        status.HTTP_200_OK: OrganizationSerializer(many=True),
+        status.HTTP_401_UNAUTHORIZED: "The user is not authenticated",
+    },
+)
 class OrgsAPIView(generics.ListAPIView):
     """
     API view for listing orgs