Fix: Make swagger doc compliant to OpenAPI (#3394)

This fixes issues in the swagger.json file. The motivation to do so is to be able to generate API clients using https://openapi-generator.tech Doing so will require further changes to the api spec, but this seems like a good first step since it is now "valid" according to editor.swagger.io and openapi-generator validate.

Fixes #2806

swagger/paths/application/contacts/crud.yml

@@ -1,16 +1,17 @@
+parameters:
+  - $ref: '#/parameters/account_id'
+  - name: id
+    in: path
+    type: number
+    description: ID of the contact
+    required: true
+
 get:
   tags:
     - Contact
   operationId: contactDetails
   summary: Show Contact
   description: Get a contact belonging to the account using ID
-  parameters:
-    - $ref: '#/parameters/account_id'
-    - name: id
-      in: path
-      type: number
-      description: ID of the contact
-      required: true
   responses:
     200:
       description: Success
@@ -28,12 +29,6 @@ put:
   summary: Update Contact
   description: Update a contact belonging to the account using ID
   parameters:
-    - $ref: '#/parameters/account_id'
-    - name: id
-      in: path
-      type: number
-      description: ID of the contact
-      required: true
     - name: data
       in: body
       required: true
@@ -54,16 +49,10 @@ delete:
     - Contact
   operationId: contactDelete
   summary: Delete Contact
-  parameters:
-    - name: id
-      in: path
-      type: number
-      description: ID of the contact
-      required: true
   responses:
     200:
       description: Success
     401:
       description: Unauthorized
     404:
-      description: Contact not found
+      description: Contact not found