Add documentation for PUT on file endpoints

swagger/responses/index.yaml

@@ -22,6 +22,22 @@
     example:
       modified: 1
 
+'200:modified-with-count-and-jobs':
+  description: The number of records modified and number of jobs started.
+  schema:
+    type: object
+    properties:
+      modified:
+        type: integer
+      jobs_triggered:
+        type: integer
+    required:
+      - modified
+      - jobs_triggered
+    example:
+      modified: 1
+      jobs_triggered: 0
+
 '400:invalid-body-json':
   description: |
     JSON did not validate against schema for this endpoint.

swagger/templates/file-item.yaml

@@ -87,6 +87,21 @@ template: |
       '200':
         $ref: '#/responses/200:deleted-with-count'
 
+  put:
+    summary: Modify a file's attributes
+    operationId: modify_{{resource}}_file
+    tags:
+    - '{{tag}}'
+    parameters:
+      - name: body
+        in: body
+        required: true
+        schema:
+          $ref: schemas/input/file-update.json
+    responses:
+      '200':
+        $ref: '#/responses/200:modified-with-count-and-jobs'
+
   delete:
     summary: Delete a file
     operationId: delete_{{resource}}_file