Merge pull request #1540 from github/openapi-update-7d386b587ced94ac77628b885faf93fbc11d4de8722f610d38043c5dd0a839db

Update OpenAPI 3.0 Descriptions

Author: mattpage

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

@@ -3515,7 +3515,7 @@
     "/enterprises/{enterprise}/consumed-licenses": {
       "get": {
         "summary": "List enterprise consumed licenses",
-        "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.",
+        "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.\n\n**Note:** The license consumption API endpoints for enterprise accounts are currently\nin Beta and are subject to change.",
         "tags": [
           "enterprise-admin"
         ],
@@ -30756,7 +30756,7 @@
       },
       "put": {
         "summary": "Create or update file contents",
-        "description": "Creates a new file or replaces an existing file in a repository.",
+        "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -34140,7 +34140,7 @@
     "/repos/{owner}/{repo}/hooks": {
       "get": {
         "summary": "List repository webhooks",
-        "description": "",
+        "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
         "tags": [
           "repos"
         ],
@@ -62799,7 +62799,15 @@
                 },
                 "github_com_enterprise_role": {
                   "type": "string",
-                  "nullable": true
+                  "nullable": true,
+                  "description": "Deprecated: The most permissive enterprise role for a user."
+                },
+                "github_com_enterprise_roles": {
+                  "type": "array",
+                  "description": "All enterprise roles for a user.",
+                  "items": {
+                    "type": "string"
+                  }
                 },
                 "visual_studio_subscription_user": {
                   "type": "boolean"
@@ -89705,6 +89713,9 @@
                 "org2:Owner"
               ],
               "github_com_enterprise_role": "owner",
+              "github_com_enterprise_roles": [
+                "owner"
+              ],
               "visual_studio_subscription_user": false,
               "github_com_verified_domain_emails": [
                 "monalisa@github.com"
@@ -89735,6 +89746,9 @@
 
               ],
               "github_com_enterprise_role": "",
+              "github_com_enterprise_roles": [
+
+              ],
               "visual_studio_subscription_user": false,
               "github_com_verified_domain_emails": [
 

descriptions/api.github.com/api.github.com.yaml

@@ -2485,6 +2485,9 @@ paths:
         Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.
         To use this endpoint, you must be an enterprise admin, and you must use an access
         token with the `read:enterprise` scope.
+
+        **Note:** The license consumption API endpoints for enterprise accounts are currently
+        in Beta and are subject to change.
       tags:
       - enterprise-admin
       operationId: enterprise-admin/get-consumed-licenses
@@ -22278,6 +22281,8 @@ paths:
     put:
       summary: Create or update file contents
       description: Creates a new file or replaces an existing file in a repository.
+        You must authenticate using an access token with the `workflow` scope to use
+        this endpoint.
       tags:
       - repos
       operationId: repos/create-or-update-file-contents
@@ -24918,7 +24923,8 @@ paths:
   "/repos/{owner}/{repo}/hooks":
     get:
       summary: List repository webhooks
-      description: ''
+      description: Lists webhooks for a repository. `last response` may return null
+        if there have not been any deliveries within 30 days.
       tags:
       - repos
       operationId: repos/list-webhooks
@@ -45490,6 +45496,13 @@ components:
               github_com_enterprise_role:
                 type: string
                 nullable: true
+                description: 'Deprecated: The most permissive enterprise role for
+                  a user.'
+              github_com_enterprise_roles:
+                type: array
+                description: All enterprise roles for a user.
+                items:
+                  type: string
               visual_studio_subscription_user:
                 type: boolean
               github_com_verified_domain_emails:
@@ -66610,6 +66623,8 @@ components:
           - org1:Owner
           - org2:Owner
           github_com_enterprise_role: owner
+          github_com_enterprise_roles:
+          - owner
           visual_studio_subscription_user: false
           github_com_verified_domain_emails:
           - monalisa@github.com
@@ -66632,6 +66647,7 @@ components:
           license_type: enterprise
           github_com_member_roles: []
           github_com_enterprise_role: ''
+          github_com_enterprise_roles: []
           visual_studio_subscription_user: false
           github_com_verified_domain_emails: []
           github_com_saml_name_id: ''

descriptions/api.github.com/dereferenced/api.github.com.deref.json

@@ -20073,7 +20073,7 @@
     "/enterprises/{enterprise}/consumed-licenses": {
       "get": {
         "summary": "List enterprise consumed licenses",
-        "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.",
+        "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.\n\n**Note:** The license consumption API endpoints for enterprise accounts are currently\nin Beta and are subject to change.",
         "tags": [
           "enterprise-admin"
         ],
@@ -20153,7 +20153,15 @@
                           },
                           "github_com_enterprise_role": {
                             "type": "string",
-                            "nullable": true
+                            "nullable": true,
+                            "description": "Deprecated: The most permissive enterprise role for a user."
+                          },
+                          "github_com_enterprise_roles": {
+                            "type": "array",
+                            "description": "All enterprise roles for a user.",
+                            "items": {
+                              "type": "string"
+                            }
                           },
                           "visual_studio_subscription_user": {
                             "type": "boolean"
@@ -20224,6 +20232,9 @@
                             "org2:Owner"
                           ],
                           "github_com_enterprise_role": "owner",
+                          "github_com_enterprise_roles": [
+                            "owner"
+                          ],
                           "visual_studio_subscription_user": false,
                           "github_com_verified_domain_emails": [
                             "monalisa@github.com"
@@ -20254,6 +20265,9 @@
 
                           ],
                           "github_com_enterprise_role": "",
+                          "github_com_enterprise_roles": [
+
+                          ],
                           "visual_studio_subscription_user": false,
                           "github_com_verified_domain_emails": [
 
@@ -240151,7 +240165,7 @@
       },
       "put": {
         "summary": "Create or update file contents",
-        "description": "Creates a new file or replaces an existing file in a repository.",
+        "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -263100,7 +263114,7 @@
     "/repos/{owner}/{repo}/hooks": {
       "get": {
         "summary": "List repository webhooks",
-        "description": "",
+        "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
         "tags": [
           "repos"
         ],

descriptions/api.github.com/dereferenced/api.github.com.deref.yaml

@@ -8649,6 +8649,9 @@ paths:
         Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.
         To use this endpoint, you must be an enterprise admin, and you must use an access
         token with the `read:enterprise` scope.
+
+        **Note:** The license consumption API endpoints for enterprise accounts are currently
+        in Beta and are subject to change.
       tags:
       - enterprise-admin
       operationId: enterprise-admin/get-consumed-licenses
@@ -8694,6 +8697,13 @@ paths:
                         github_com_enterprise_role:
                           type: string
                           nullable: true
+                          description: 'Deprecated: The most permissive enterprise
+                            role for a user.'
+                        github_com_enterprise_roles:
+                          type: array
+                          description: All enterprise roles for a user.
+                          items:
+                            type: string
                         visual_studio_subscription_user:
                           type: boolean
                         github_com_verified_domain_emails:
@@ -8741,6 +8751,8 @@ paths:
                       - org1:Owner
                       - org2:Owner
                       github_com_enterprise_role: owner
+                      github_com_enterprise_roles:
+                      - owner
                       visual_studio_subscription_user: false
                       github_com_verified_domain_emails:
                       - monalisa@github.com
@@ -8763,6 +8775,7 @@ paths:
                       license_type: enterprise
                       github_com_member_roles: []
                       github_com_enterprise_role: ''
+                      github_com_enterprise_roles: []
                       visual_studio_subscription_user: false
                       github_com_verified_domain_emails: []
                       github_com_saml_name_id: ''
@@ -47471,6 +47484,8 @@ paths:
     put:
       summary: Create or update file contents
       description: Creates a new file or replaces an existing file in a repository.
+        You must authenticate using an access token with the `workflow` scope to use
+        this endpoint.
       tags:
       - repos
       operationId: repos/create-or-update-file-contents
@@ -51774,7 +51789,8 @@ paths:
   "/repos/{owner}/{repo}/hooks":
     get:
       summary: List repository webhooks
-      description: ''
+      description: Lists webhooks for a repository. `last response` may return null
+        if there have not been any deliveries within 30 days.
       tags:
       - repos
       operationId: repos/list-webhooks

descriptions/ghes-3.2/dereferenced/ghes-3.2.deref.json

@@ -191540,7 +191540,7 @@
       },
       "put": {
         "summary": "Create or update file contents",
-        "description": "Creates a new file or replaces an existing file in a repository.",
+        "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -212931,7 +212931,7 @@
     "/repos/{owner}/{repo}/hooks": {
       "get": {
         "summary": "List repository webhooks",
-        "description": "",
+        "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
         "tags": [
           "repos"
         ],

descriptions/ghes-3.2/dereferenced/ghes-3.2.deref.yaml

@@ -40274,6 +40274,8 @@ paths:
     put:
       summary: Create or update file contents
       description: Creates a new file or replaces an existing file in a repository.
+        You must authenticate using an access token with the `workflow` scope to use
+        this endpoint.
       tags:
       - repos
       operationId: repos/create-or-update-file-contents
@@ -43930,7 +43932,8 @@ paths:
   "/repos/{owner}/{repo}/hooks":
     get:
       summary: List repository webhooks
-      description: ''
+      description: Lists webhooks for a repository. `last response` may return null
+        if there have not been any deliveries within 30 days.
       tags:
       - repos
       operationId: repos/list-webhooks

descriptions/ghes-3.2/ghes-3.2.json

@@ -26851,7 +26851,7 @@
       },
       "put": {
         "summary": "Create or update file contents",
-        "description": "Creates a new file or replaces an existing file in a repository.",
+        "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -29862,7 +29862,7 @@
     "/repos/{owner}/{repo}/hooks": {
       "get": {
         "summary": "List repository webhooks",
-        "description": "",
+        "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
         "tags": [
           "repos"
         ],