Merge pull request #462 from snyk/docs/automatic-api-docs-update

Generate API docs from spec

Author: mikeromard

docs/.gitbook/assets/rest-spec.json

@@ -907,7 +907,8 @@
         "style": "form"
       },
       "OrgId": {
-        "description": "Unique identifier for an organization",
+        "description": "The ID of the organization.",
+        "example": "0d3728ec-eebf-484d-9907-ba238019f10b",
         "in": "path",
         "name": "org_id",
         "required": true,
@@ -20042,15 +20043,7 @@
             "$ref": "#/components/parameters/Version"
           },
           {
-            "description": "The ID of the organization.",
-            "example": "0d3728ec-eebf-484d-9907-ba238019f10b",
-            "in": "path",
-            "name": "org_id",
-            "required": true,
-            "schema": {
-              "format": "uuid",
-              "type": "string"
-            }
+            "$ref": "#/components/parameters/OrgId"
           },
           {
             "$ref": "#/components/parameters/Cursor"
@@ -26074,7 +26067,14 @@
             "$ref": "#/components/parameters/Version"
           },
           {
-            "$ref": "#/components/parameters/OrgId"
+            "description": "Unique identifier for an organization",
+            "in": "path",
+            "name": "org_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
           }
         ],
         "requestBody": {
@@ -26170,7 +26170,14 @@
             "$ref": "#/components/parameters/PackageUrl"
           },
           {
-            "$ref": "#/components/parameters/OrgId"
+            "description": "Unique identifier for an organization",
+            "in": "path",
+            "name": "org_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
           },
           {
             "description": "Specify the number of results to skip before returning results. Must be greater than or equal to 0. Default is 0.",
@@ -35474,7 +35481,14 @@
             "$ref": "#/components/parameters/Version"
           },
           {
-            "$ref": "#/components/parameters/OrgId"
+            "description": "Unique identifier for an organization",
+            "in": "path",
+            "name": "org_id",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
           },
           {
             "description": "Unique identifier for a project",