Merge pull request #5238 from github/openapi-update-6d20039bab0595721beed5bea6cc5574ef5a2275ac4a4a2ae8e259e6b3365e03

Update OpenAPI 3.1 Descriptions

Author: shiftkey

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

@@ -7896,6 +7896,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -7906,7 +7909,8 @@
                 "default": {
                   "value": {
                     "enabled_repositories": "all",
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -29809,6 +29813,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -29819,7 +29826,8 @@
                 "default": {
                   "value": {
                     "enabled": true,
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -108280,6 +108288,10 @@
         "type": "string",
         "description": "The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` is set to `selected`."
       },
+      "sha-pinning-required": {
+        "type": "boolean",
+        "description": "Whether actions must be pinned to a full-length commit SHA."
+      },
       "actions-organization-permissions": {
         "type": "object",
         "properties": {
@@ -108295,6 +108307,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -118544,6 +118559,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -286475,7 +286493,8 @@
         "value": {
           "enabled_repositories": "all",
           "allowed_actions": "selected",
-          "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions"
+          "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions",
+          "sha_pinning_required": true
         }
       },
       "actions-fork-pr-contributor-approval": {
@@ -293716,7 +293735,8 @@
         "value": {
           "enabled": true,
           "allowed_actions": "selected",
-          "selected_actions_url": "https://api.github.com/repositories/42/actions/permissions/selected-actions"
+          "selected_actions_url": "https://api.github.com/repositories/42/actions/permissions/selected-actions",
+          "sha_pinning_required": true
         }
       },
       "actions-workflow-access-to-repository": {

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

@@ -5690,13 +5690,16 @@ paths:
                   "$ref": "#/components/schemas/enabled-repositories"
                 allowed_actions:
                   "$ref": "#/components/schemas/allowed-actions"
+                sha_pinning_required:
+                  "$ref": "#/components/schemas/sha-pinning-required"
               required:
               - enabled_repositories
             examples:
               default:
                 value:
                   enabled_repositories: all
                   allowed_actions: selected
+                  sha_pinning_required: true
       x-github:
         enabledForGitHubApps: true
         githubCloudOnly: false
@@ -21661,13 +21664,16 @@ paths:
                   "$ref": "#/components/schemas/actions-enabled"
                 allowed_actions:
                   "$ref": "#/components/schemas/allowed-actions"
+                sha_pinning_required:
+                  "$ref": "#/components/schemas/sha-pinning-required"
               required:
               - enabled
             examples:
               default:
                 value:
                   enabled: true
                   allowed_actions: selected
+                  sha_pinning_required: true
       x-github:
         enabledForGitHubApps: true
         githubCloudOnly: false
@@ -78477,6 +78483,9 @@ components:
       type: string
       description: The API URL to use to get or set the actions and reusable workflows
         that are allowed to run, when `allowed_actions` is set to `selected`.
+    sha-pinning-required:
+      type: boolean
+      description: Whether actions must be pinned to a full-length commit SHA.
     actions-organization-permissions:
       type: object
       properties:
@@ -78491,6 +78500,8 @@ components:
           "$ref": "#/components/schemas/allowed-actions"
         selected_actions_url:
           "$ref": "#/components/schemas/selected-actions-url"
+        sha_pinning_required:
+          "$ref": "#/components/schemas/sha-pinning-required"
       required:
       - enabled_repositories
     actions-artifact-and-log-retention-response:
@@ -86150,6 +86161,8 @@ components:
           "$ref": "#/components/schemas/allowed-actions"
         selected_actions_url:
           "$ref": "#/components/schemas/selected-actions-url"
+        sha_pinning_required:
+          "$ref": "#/components/schemas/sha-pinning-required"
       required:
       - enabled
     actions-workflow-access-to-repository:
@@ -211457,6 +211470,7 @@ components:
         enabled_repositories: all
         allowed_actions: selected
         selected_actions_url: https://api.github.com/organizations/42/actions/permissions/selected-actions
+        sha_pinning_required: true
     actions-fork-pr-contributor-approval:
       value:
         approval_policy: first_time_contributors
@@ -217616,6 +217630,7 @@ components:
         enabled: true
         allowed_actions: selected
         selected_actions_url: https://api.github.com/repositories/42/actions/permissions/selected-actions
+        sha_pinning_required: true
     actions-workflow-access-to-repository:
       value:
         access_level: organization

descriptions-next/api.github.com/api.github.com.json

@@ -7896,6 +7896,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -7906,7 +7909,8 @@
                 "default": {
                   "value": {
                     "enabled_repositories": "all",
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -29809,6 +29813,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -29819,7 +29826,8 @@
                 "default": {
                   "value": {
                     "enabled": true,
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -108280,6 +108288,10 @@
         "type": "string",
         "description": "The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` is set to `selected`."
       },
+      "sha-pinning-required": {
+        "type": "boolean",
+        "description": "Whether actions must be pinned to a full-length commit SHA."
+      },
       "actions-organization-permissions": {
         "type": "object",
         "properties": {
@@ -108295,6 +108307,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -118544,6 +118559,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -286475,7 +286493,8 @@
         "value": {
           "enabled_repositories": "all",
           "allowed_actions": "selected",
-          "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions"
+          "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions",
+          "sha_pinning_required": true
         }
       },
       "actions-fork-pr-contributor-approval": {
@@ -293716,7 +293735,8 @@
         "value": {
           "enabled": true,
           "allowed_actions": "selected",
-          "selected_actions_url": "https://api.github.com/repositories/42/actions/permissions/selected-actions"
+          "selected_actions_url": "https://api.github.com/repositories/42/actions/permissions/selected-actions",
+          "sha_pinning_required": true
         }
       },
       "actions-workflow-access-to-repository": {

descriptions-next/api.github.com/api.github.com.yaml

@@ -5690,13 +5690,16 @@ paths:
                   "$ref": "#/components/schemas/enabled-repositories"
                 allowed_actions:
                   "$ref": "#/components/schemas/allowed-actions"
+                sha_pinning_required:
+                  "$ref": "#/components/schemas/sha-pinning-required"
               required:
               - enabled_repositories
             examples:
               default:
                 value:
                   enabled_repositories: all
                   allowed_actions: selected
+                  sha_pinning_required: true
       x-github:
         enabledForGitHubApps: true
         githubCloudOnly: false
@@ -21661,13 +21664,16 @@ paths:
                   "$ref": "#/components/schemas/actions-enabled"
                 allowed_actions:
                   "$ref": "#/components/schemas/allowed-actions"
+                sha_pinning_required:
+                  "$ref": "#/components/schemas/sha-pinning-required"
               required:
               - enabled
             examples:
               default:
                 value:
                   enabled: true
                   allowed_actions: selected
+                  sha_pinning_required: true
       x-github:
         enabledForGitHubApps: true
         githubCloudOnly: false
@@ -78477,6 +78483,9 @@ components:
       type: string
       description: The API URL to use to get or set the actions and reusable workflows
         that are allowed to run, when `allowed_actions` is set to `selected`.
+    sha-pinning-required:
+      type: boolean
+      description: Whether actions must be pinned to a full-length commit SHA.
     actions-organization-permissions:
       type: object
       properties:
@@ -78491,6 +78500,8 @@ components:
           "$ref": "#/components/schemas/allowed-actions"
         selected_actions_url:
           "$ref": "#/components/schemas/selected-actions-url"
+        sha_pinning_required:
+          "$ref": "#/components/schemas/sha-pinning-required"
       required:
       - enabled_repositories
     actions-artifact-and-log-retention-response:
@@ -86150,6 +86161,8 @@ components:
           "$ref": "#/components/schemas/allowed-actions"
         selected_actions_url:
           "$ref": "#/components/schemas/selected-actions-url"
+        sha_pinning_required:
+          "$ref": "#/components/schemas/sha-pinning-required"
       required:
       - enabled
     actions-workflow-access-to-repository:
@@ -211457,6 +211470,7 @@ components:
         enabled_repositories: all
         allowed_actions: selected
         selected_actions_url: https://api.github.com/organizations/42/actions/permissions/selected-actions
+        sha_pinning_required: true
     actions-fork-pr-contributor-approval:
       value:
         approval_policy: first_time_contributors
@@ -217616,6 +217630,7 @@ components:
         enabled: true
         allowed_actions: selected
         selected_actions_url: https://api.github.com/repositories/42/actions/permissions/selected-actions
+        sha_pinning_required: true
     actions-workflow-access-to-repository:
       value:
         access_level: organization