fix: Add swagger definition for platform_user_id (#2385)

swagger/parameters/index.yml

@@ -24,3 +24,6 @@ contact_sort_param:
 
 page:
   $ref: ./page.yml
+
+platform_user_id:
+  $ref: ./platform_user_id.yml

swagger/parameters/platform_user_id.yml

@@ -0,0 +1,6 @@
+in: path
+name: id
+schema:
+  type: integer
+required: true
+description: The numeric ID of the user on the platform

swagger/paths/index.yml

@@ -52,7 +52,7 @@ platform/api/v1/users:
     $ref: ./platform/users/create.yml
 platform/api/v1/users/{id}:
   parameters:
-    - $ref: '#/parameters/user_id'
+    - $ref: '#/parameters/platform_user_id'
   get:
     $ref: './platform/users/show.yml'
   patch:
@@ -61,7 +61,7 @@ platform/api/v1/users/{id}:
     $ref: ./platform/users/delete.yml
 platform/api/v1/users/{id}/login:
   parameters:
-    - $ref: '#/parameters/user_id'
+    - $ref: '#/parameters/platform_user_id'
   $ref: './platform/users/login.yml'
 
 
@@ -215,4 +215,3 @@ platform/api/v1/users/{id}/login:
     $ref: ./teams/update.yml
   delete:
     $ref: ./teams/delete.yml
-

swagger/swagger.json

@@ -550,7 +550,7 @@
     "platform/api/v1/users/{id}": {
       "parameters": [
         {
-          "$ref": "#/parameters/user_id"
+          "$ref": "#/parameters/platform_user_id"
         }
       ],
       "get": {
@@ -3201,6 +3201,15 @@
       },
       "required": false,
       "description": "The page parameter"
+    },
+    "platform_user_id": {
+      "in": "path",
+      "name": "id",
+      "schema": {
+        "type": "integer"
+      },
+      "required": true,
+      "description": "The numeric ID of the user on the platform"
     }
   },
   "x-tagGroups": [