Add endpoint for fetching currently running csv imports

.pylintrc

@@ -124,7 +124,7 @@ indent-string='    '
 max-line-length=100
 
 # Maximum number of lines in a module
-max-module-lines=1000
+max-module-lines=1010
 
 # List of optional constructs for which whitespace checking is disabled. `dict-
 # separator` is used to allow tabulation in dicts, etc.: {1  : 1,\n222: 2}.

docs/forms.rst

@@ -1628,3 +1628,4 @@ If the upload is still running:
        {
            "job_status": "PENDING"
        }
+

docs/imports.rst

@@ -0,0 +1,64 @@
+Check active imports
+--------------------
+
+.. raw:: html
+
+    <pre class="prettyprint"><b>GET</b> /api/v2/imports/{form_id}</pre>
+
+Example
+^^^^^^^
+::
+
+       curl -X GET https://api.ona.io/api/v2/imports/{form_id}
+
+Response
+^^^^^^^^
+
+::
+
+      [
+        {
+            "job_uuid": "256dcef5-1baa-48ee-83a3-f7100123f5d2",
+            "time_start": "2022-09-29T09:08:59"
+        }
+    ]
+
+
+Stops a queued/on-going import task
+-----------------------------------
+
+.. raw:: html
+
+    <pre class="prettyprint"><b>DELTE</b> /api/v2/imports/{form_id}?task_uuid={task_uuid}</pre>
+
+Example
+^^^^^^^
+::
+
+       curl -X DELETE https://api.ona.io/api/v2/imports/{form_id}?task_uuid={task_uuid}
+
+Response
+^^^^^^^^
+
+::
+    HTTP 204 NO CONTENT
+
+
+Starts a new Import task for a given form
+-----------------------------------
+
+.. raw:: html
+
+    <pre class="prettyprint"><b>POST</b> /api/v2/imports/{form_id}</pre>
+
+Example
+^^^^^^^
+::
+
+       cur-X POST  -F 'csv_file=@<path to csv file>'  https://api.ona.io/api/v2/imports/{form_id}
+
+Response
+^^^^^^^^
+
+::
+    {"task_id":"0819b3b0-f0e5-4a6b-83aa-addab20fe208"}

onadata/apps/api/permissions.py

@@ -127,6 +127,18 @@ class DjangoObjectPermissionsAllowAnon(DjangoObjectPermissions):
     authenticated_users_only = False
 
 
+# pylint: disable=too-few-public-methods
+class ImportPermissions(DjangoObjectPermissions):
+    """
+    ImportPermissions - custom permissions check on Imports viewset.
+    """
+
+    authenticated_users_only = True
+
+    def has_object_permission(self, request, view, obj):
+        return request.user.has_perm(CAN_CHANGE_XFORM, obj)
+
+
 class XFormPermissions(DjangoObjectPermissions):
     """
     XFormPermissions - custom permissions check on XForm viewset.

onadata/apps/api/tests/viewsets/test_ona_api.py

@@ -30,4 +30,4 @@ def test_number_of_v2_viewsets(self):
         request = self.factory.get(path)
         request.resolver_match = resolve(path)
         response = view(request)
-        self.assertEqual(len(response.data), 1)
+        self.assertEqual(len(response.data), 2)