`: Kept.
diff --git a/kpi/views/v2/asset.py b/kpi/views/v2/asset.py
index 866418c0b3..df4c1c0ce1 100644
--- a/kpi/views/v2/asset.py
+++ b/kpi/views/v2/asset.py
@@ -253,7 +253,8 @@ class AssetViewSet(NestedViewSetMixin, viewsets.ModelViewSet):
> curl -X GET https://[kpi]/api/v2/assets/aSAvYreNzVEkrWg5Gdcvg/reports/
### Data sharing
- Enable data sharing for the current asset
+
+ Control sharing of submission data from this project to other projects
PATCH /api/v2/assets/{uid}/
@@ -273,7 +274,10 @@ class AssetViewSet(NestedViewSetMixin, viewsets.ModelViewSet):
> }
>
- * `fields`: Optional. List of questions of asset represented by their XPath. I.e., Hierarchy group must be kept.
+ * `fields`: Optional. List of questions whose responses will be shared. If
+ missing or empty, all responses will be shared. Questions must be
+ identified by full group path separated by slashes, e.g.
+ `group/subgroup/question_name`.
>
> Response
diff --git a/kpi/views/v2/paired_data.py b/kpi/views/v2/paired_data.py
index 109e293864..0f3da4cba1 100644
--- a/kpi/views/v2/paired_data.py
+++ b/kpi/views/v2/paired_data.py
@@ -56,7 +56,8 @@ class PairedDataViewset(AssetNestedObjectViewsetMixin,
> }
>
- The endpoint is paginated. Accept these parameters:
+ This endpoint is paginated and accepts these parameters:
+
- `offset`: The initial index from which to return the results
- `limit`: Number of results to return per page
@@ -90,8 +91,11 @@ class PairedDataViewset(AssetNestedObjectViewsetMixin,
> }
>
- * `fields`: Optional. List of questions of source asset represented by their XPath I.e., Hierarchy group must be kept.
- * `filename`: Must be unique among all asset files. Only accept letters, numbers and '-'.
+ * `fields`: Optional. List of questions whose responses will be retrieved
+ from the source data. If missing or empty, all responses will be
+ retrieved. Questions must be identified by full group path separated by
+ slashes, e.g. `group/subgroup/question_name`.
+ * `filename`: Must be unique among all asset files. Only accepts letters, numbers and '-'.
### Retrieve a project
@@ -184,6 +188,9 @@ class PairedDataViewset(AssetNestedObjectViewsetMixin,
def external(self, request, paired_data_uid, **kwargs):
"""
Returns an XML which contains data submitted to paired asset
+ Creates the endpoints
+ - /api/v2/assets//paired-data//external/
+ - /api/v2/assets//paired-data//external.xml/
"""
paired_data = self.get_object()