include swagger documentation updated

gateway/api/v1/views/files.py

@@ -64,19 +64,26 @@ def provider_list(self, request):
         return super().provider_list(request)
 
     @swagger_auto_schema(
-        operation_description="Download a specific file",
+        operation_description="Download a specific file in the user directory",
         manual_parameters=[
             openapi.Parameter(
                 "file",
                 openapi.IN_QUERY,
-                description="file name",
+                description="File name",
+                type=openapi.TYPE_STRING,
+                required=True,
+            ),
+            openapi.Parameter(
+                "function",
+                openapi.IN_QUERY,
+                description="Qiskit Function title",
                 type=openapi.TYPE_STRING,
                 required=True,
             ),
             openapi.Parameter(
                 "provider",
                 openapi.IN_QUERY,
-                description="provider name",
+                description="Provider name",
                 type=openapi.TYPE_STRING,
                 required=False,
             ),
@@ -86,6 +93,36 @@ def provider_list(self, request):
     def download(self, request):
         return super().download(request)
 
+    @swagger_auto_schema(
+        operation_description="Download a specific file in the provider directory",
+        manual_parameters=[
+            openapi.Parameter(
+                "file",
+                openapi.IN_QUERY,
+                description="File name",
+                type=openapi.TYPE_STRING,
+                required=True,
+            ),
+            openapi.Parameter(
+                "function",
+                openapi.IN_QUERY,
+                description="Qiskit Function title",
+                type=openapi.TYPE_STRING,
+                required=True,
+            ),
+            openapi.Parameter(
+                "provider",
+                openapi.IN_QUERY,
+                description="Provider name",
+                type=openapi.TYPE_STRING,
+                required=True,
+            ),
+        ],
+    )
+    @action(methods=["GET"], detail=False, url_path="provider/download")
+    def provider_download(self, request):
+        return super().provider_download(request)
+
     @swagger_auto_schema(
         operation_description="Deletes file uploaded or produced by the programs",
         request_body=openapi.Schema(