feat(api): enhance AccountDetailsView with detailed OpenAPI response schemas

api/v1alpha/views.py

@@ -3,7 +3,7 @@ Views implementing the API endpoints.
 
 """
 
-from drf_spectacular.utils import extend_schema
+from drf_spectacular.utils import OpenApiResponse, extend_schema
 from rest_framework import generics
 
 from api.v1alpha.serializers import AccountSerializer
@@ -13,6 +13,17 @@ from api.v1alpha.serializers import AccountSerializer
     tags=["Account details"],
     summary="Retrieve or update account details of the current logged in account",
     description="Endpoint that returns or updates the details of the current logged in account.",
+    responses={
+        200: OpenApiResponse(
+            response=AccountSerializer,
+            description="Successful retrieval or update of account details.",
+        ),
+        204: OpenApiResponse(
+            description="Successful update with no content to return when updating certain fields."
+        ),
+        405: OpenApiResponse(description="Method not allowed."),
+    },
+    methods=["GET", "PATCH"],
 )
 class AccountDetailsView(generics.RetrieveUpdateAPIView):
     serializer_class = AccountSerializer