Merge pull request #3364 from github/openapi-update-da8d4acbe8f92ab0f53b65b1b558fc55022af249ef089d8415b613310a6cacdc

Update OpenAPI 3.0 Descriptions

Author: shiftkey

descriptions/api.github.com/api.github.com.2022-11-28.json

@@ -25569,25 +25569,22 @@
     },
     "/repos/{owner}/{repo}/autolinks": {
       "get": {
-        "summary": "List all autolinks of a repository",
-        "description": "This returns a list of autolinks configured for the given repository.\n\nInformation about autolinks are only available to repository administrators.",
+        "summary": "Get all autolinks of a repository",
+        "description": "Gets all autolinks that are configured for a repository.\n\nInformation about autolinks are only available to repository administrators.",
         "tags": [
           "repos"
         ],
         "operationId": "repos/list-autolinks",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/repos/autolinks#list-all-autolinks-of-a-repository"
+          "url": "https://docs.github.com/rest/repos/autolinks#get-all-autolinks-of-a-repository"
         },
         "parameters": [
           {
             "$ref": "#/components/parameters/owner"
           },
           {
             "$ref": "#/components/parameters/repo"
-          },
-          {
-            "$ref": "#/components/parameters/page"
           }
         ],
         "responses": {
@@ -98809,6 +98806,24 @@
           }
         }
       },
+      "repository-rule-params-restricted-commits": {
+        "title": "RestrictedCommits",
+        "description": "Restricted commit",
+        "type": "object",
+        "properties": {
+          "oid": {
+            "type": "string",
+            "description": "Full or abbreviated commit hash to reject"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Reason for restriction"
+          }
+        },
+        "required": [
+          "oid"
+        ]
+      },
       "repository-rule-params-workflow-file-reference": {
         "title": "WorkflowFileReference",
         "description": "A workflow that must run for this rule to pass",

descriptions/api.github.com/api.github.com.2022-11-28.yaml

@@ -18310,21 +18310,20 @@ paths:
         subcategory: assignees
   "/repos/{owner}/{repo}/autolinks":
     get:
-      summary: List all autolinks of a repository
+      summary: Get all autolinks of a repository
       description: |-
-        This returns a list of autolinks configured for the given repository.
+        Gets all autolinks that are configured for a repository.
 
         Information about autolinks are only available to repository administrators.
       tags:
       - repos
       operationId: repos/list-autolinks
       externalDocs:
         description: API method documentation
-        url: https://docs.github.com/rest/repos/autolinks#list-all-autolinks-of-a-repository
+        url: https://docs.github.com/rest/repos/autolinks#get-all-autolinks-of-a-repository
       parameters:
       - "$ref": "#/components/parameters/owner"
       - "$ref": "#/components/parameters/repo"
-      - "$ref": "#/components/parameters/page"
       responses:
         '200':
           description: Response
@@ -72010,6 +72009,19 @@ components:
           required:
           - operator
           - pattern
+    repository-rule-params-restricted-commits:
+      title: RestrictedCommits
+      description: Restricted commit
+      type: object
+      properties:
+        oid:
+          type: string
+          description: Full or abbreviated commit hash to reject
+        reason:
+          type: string
+          description: Reason for restriction
+      required:
+      - oid
     repository-rule-params-workflow-file-reference:
       title: WorkflowFileReference
       description: A workflow that must run for this rule to pass

descriptions/api.github.com/api.github.com.json

@@ -25569,25 +25569,22 @@
     },
     "/repos/{owner}/{repo}/autolinks": {
       "get": {
-        "summary": "List all autolinks of a repository",
-        "description": "This returns a list of autolinks configured for the given repository.\n\nInformation about autolinks are only available to repository administrators.",
+        "summary": "Get all autolinks of a repository",
+        "description": "Gets all autolinks that are configured for a repository.\n\nInformation about autolinks are only available to repository administrators.",
         "tags": [
           "repos"
         ],
         "operationId": "repos/list-autolinks",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/repos/autolinks#list-all-autolinks-of-a-repository"
+          "url": "https://docs.github.com/rest/repos/autolinks#get-all-autolinks-of-a-repository"
         },
         "parameters": [
           {
             "$ref": "#/components/parameters/owner"
           },
           {
             "$ref": "#/components/parameters/repo"
-          },
-          {
-            "$ref": "#/components/parameters/page"
           }
         ],
         "responses": {
@@ -98809,6 +98806,24 @@
           }
         }
       },
+      "repository-rule-params-restricted-commits": {
+        "title": "RestrictedCommits",
+        "description": "Restricted commit",
+        "type": "object",
+        "properties": {
+          "oid": {
+            "type": "string",
+            "description": "Full or abbreviated commit hash to reject"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Reason for restriction"
+          }
+        },
+        "required": [
+          "oid"
+        ]
+      },
       "repository-rule-params-workflow-file-reference": {
         "title": "WorkflowFileReference",
         "description": "A workflow that must run for this rule to pass",