Merge pull request #5237 from github/openapi-update-99b4107f2346621a355515f82c20496366e3b665e88f2cf50b90be0c5529bbcc

Update OpenAPI 3.0 Descriptions

Author: shiftkey

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

@@ -7854,6 +7854,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -7864,7 +7867,8 @@
                 "default": {
                   "value": {
                     "enabled_repositories": "all",
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -29677,6 +29681,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -29687,7 +29694,8 @@
                 "default": {
                   "value": {
                     "enabled": true,
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -106863,6 +106871,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": {
@@ -106878,6 +106890,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -116762,6 +116777,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -277677,7 +277695,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": {
@@ -284918,7 +284937,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/api.github.com/api.github.com.2022-11-28.yaml

@@ -5671,13 +5671,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
@@ -21598,13 +21601,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
@@ -78015,6 +78021,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:
@@ -78029,6 +78038,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:
@@ -85893,6 +85904,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:
@@ -208250,6 +208263,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
@@ -214409,6 +214423,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/api.github.com/api.github.com.json

@@ -7854,6 +7854,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -7864,7 +7867,8 @@
                 "default": {
                   "value": {
                     "enabled_repositories": "all",
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -29677,6 +29681,9 @@
                   },
                   "allowed_actions": {
                     "$ref": "#/components/schemas/allowed-actions"
+                  },
+                  "sha_pinning_required": {
+                    "$ref": "#/components/schemas/sha-pinning-required"
                   }
                 },
                 "required": [
@@ -29687,7 +29694,8 @@
                 "default": {
                   "value": {
                     "enabled": true,
-                    "allowed_actions": "selected"
+                    "allowed_actions": "selected",
+                    "sha_pinning_required": true
                   }
                 }
               }
@@ -106863,6 +106871,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": {
@@ -106878,6 +106890,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -116762,6 +116777,9 @@
           },
           "selected_actions_url": {
             "$ref": "#/components/schemas/selected-actions-url"
+          },
+          "sha_pinning_required": {
+            "$ref": "#/components/schemas/sha-pinning-required"
           }
         },
         "required": [
@@ -277677,7 +277695,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": {
@@ -284918,7 +284937,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/api.github.com/api.github.com.yaml

@@ -5671,13 +5671,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
@@ -21598,13 +21601,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
@@ -78015,6 +78021,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:
@@ -78029,6 +78038,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:
@@ -85893,6 +85904,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:
@@ -208250,6 +208263,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
@@ -214409,6 +214423,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