Update OpenAPI 3.1 Descriptions

github · Jul 27, 2023 · c12a60a · c12a60a
1 parent 8482a8d
commit c12a60a
Show file tree

Hide file tree

Showing 24 changed files with 260 additions and 260 deletions.
diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.json b/descriptions-next/api.github.com/api.github.com.2022-11-28.json
@@ -7713,14 +7713,14 @@
         }
       }
     },
-    "/orgs/{org}/codespaces/billing": {
+    "/orgs/{org}/codespaces/access": {
       "put": {
         "summary": "Manage access control for organization codespaces",
-        "description": "Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces billing permissions for users according to the visibility.\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
+        "description": "Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces access permissions for users according to the visibility.\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
         "tags": [
           "codespaces"
         ],
-        "operationId": "codespaces/set-codespaces-billing",
+        "operationId": "codespaces/set-codespaces-access",
         "externalDocs": {
           "description": "API method documentation",
           "url": "https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces"
@@ -7803,17 +7803,17 @@
         }
       }
     },
-    "/orgs/{org}/codespaces/billing/selected_users": {
+    "/orgs/{org}/codespaces/access/selected_users": {
       "post": {
-        "summary": "Add users to Codespaces billing for an organization",
-        "description": "Codespaces for the specified users will be billed to the organization.\n\nTo use this endpoint, the billing settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
+        "summary": "Add users to Codespaces access for an organization",
+        "description": "Codespaces for the specified users will be billed to the organization.\n\nTo use this endpoint, the access settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
         "tags": [
           "codespaces"
         ],
-        "operationId": "codespaces/set-codespaces-billing-users",
+        "operationId": "codespaces/set-codespaces-access-users",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/codespaces/organizations#add-users-to-codespaces-billing-for-an-organization"
+          "url": "https://docs.github.com/rest/codespaces/organizations#add-users-to-codespaces-access-for-an-organization"
         },
         "parameters": [
           {
@@ -7882,15 +7882,15 @@
         }
       },
       "delete": {
-        "summary": "Remove users from Codespaces billing for an organization",
-        "description": "Codespaces for the specified users will no longer be billed to the organization.\n\nTo use this endpoint, the billing settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
+        "summary": "Remove users from Codespaces access for an organization",
+        "description": "Codespaces for the specified users will no longer be billed to the organization.\n\nTo use this endpoint, the access settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
         "tags": [
           "codespaces"
         ],
-        "operationId": "codespaces/delete-codespaces-billing-users",
+        "operationId": "codespaces/delete-codespaces-access-users",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/codespaces/organizations#remove-users-from-codespaces-billing-for-an-organization"
+          "url": "https://docs.github.com/rest/codespaces/organizations#remove-users-from-codespaces-access-for-an-organization"
         },
         "deprecated": true,
         "parameters": [
@@ -43456,8 +43456,8 @@
                     "type": "string",
                     "description": "The level at which the comment is targeted.",
                     "enum": [
-                      "LINE",
-                      "FILE"
+                      "line",
+                      "file"
                     ]
                   }
                 },
@@ -100816,7 +100816,7 @@
             ]
           },
           "languages": {
-            "description": "CodeQL languages to be analyzed. Supported values are: `c-cpp`, `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, and `ruby`.",
+            "description": "CodeQL languages to be analyzed. Supported values are: `c-cpp`, `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, `ruby`, and `swift`.",
             "type": "array",
             "items": {
               "type": "string",

diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml
@@ -5569,15 +5569,15 @@ paths:
         enabledForGitHubApps: false
         category: codespaces
         subcategory: organizations
-  "/orgs/{org}/codespaces/billing":
+  "/orgs/{org}/codespaces/access":
     put:
       summary: Manage access control for organization codespaces
       description: |-
-        Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces billing permissions for users according to the visibility.
+        Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces access permissions for users according to the visibility.
         You must authenticate using an access token with the `admin:org` scope to use this endpoint.
       tags:
       - codespaces
-      operationId: codespaces/set-codespaces-billing
+      operationId: codespaces/set-codespaces-access
       externalDocs:
         description: API method documentation
         url: https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces
@@ -5636,22 +5636,22 @@ paths:
         enabledForGitHubApps: false
         category: codespaces
         subcategory: organizations
-  "/orgs/{org}/codespaces/billing/selected_users":
+  "/orgs/{org}/codespaces/access/selected_users":
     post:
-      summary: Add users to Codespaces billing for an organization
+      summary: Add users to Codespaces access for an organization
       description: |-
         Codespaces for the specified users will be billed to the organization.
 
-        To use this endpoint, the billing settings for the organization must be set to `selected_members`.
+        To use this endpoint, the access settings for the organization must be set to `selected_members`.
         For information on how to change this setting, see "[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces)."
 
         You must authenticate using an access token with the `admin:org` scope to use this endpoint.
       tags:
       - codespaces
-      operationId: codespaces/set-codespaces-billing-users
+      operationId: codespaces/set-codespaces-access-users
       externalDocs:
         description: API method documentation
-        url: https://docs.github.com/rest/codespaces/organizations#add-users-to-codespaces-billing-for-an-organization
+        url: https://docs.github.com/rest/codespaces/organizations#add-users-to-codespaces-access-for-an-organization
       parameters:
       - "$ref": "#/components/parameters/org"
       deprecated: true
@@ -5696,20 +5696,20 @@ paths:
         category: codespaces
         subcategory: organizations
     delete:
-      summary: Remove users from Codespaces billing for an organization
+      summary: Remove users from Codespaces access for an organization
       description: |-
         Codespaces for the specified users will no longer be billed to the organization.
 
-        To use this endpoint, the billing settings for the organization must be set to `selected_members`.
+        To use this endpoint, the access settings for the organization must be set to `selected_members`.
         For information on how to change this setting, see "[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces)."
 
         You must authenticate using an access token with the `admin:org` scope to use this endpoint.
       tags:
       - codespaces
-      operationId: codespaces/delete-codespaces-billing-users
+      operationId: codespaces/delete-codespaces-access-users
       externalDocs:
         description: API method documentation
-        url: https://docs.github.com/rest/codespaces/organizations#remove-users-from-codespaces-billing-for-an-organization
+        url: https://docs.github.com/rest/codespaces/organizations#remove-users-from-codespaces-access-for-an-organization
       deprecated: true
       parameters:
       - "$ref": "#/components/parameters/org"
@@ -31481,8 +31481,8 @@ paths:
                   type: string
                   description: The level at which the comment is targeted.
                   enum:
-                  - LINE
-                  - FILE
+                  - line
+                  - file
               required:
               - body
               - commit_id
@@ -72734,8 +72734,8 @@ components:
           - extended
         languages:
           description: 'CodeQL languages to be analyzed. Supported values are: `c-cpp`,
-            `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, and
-            `ruby`.'
+            `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, `ruby`,
+            and `swift`.'
           type: array
           items:
             type: string

diff --git a/descriptions-next/api.github.com/api.github.com.json b/descriptions-next/api.github.com/api.github.com.json
@@ -7713,14 +7713,14 @@
         }
       }
     },
-    "/orgs/{org}/codespaces/billing": {
+    "/orgs/{org}/codespaces/access": {
       "put": {
         "summary": "Manage access control for organization codespaces",
-        "description": "Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces billing permissions for users according to the visibility.\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
+        "description": "Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces access permissions for users according to the visibility.\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
         "tags": [
           "codespaces"
         ],
-        "operationId": "codespaces/set-codespaces-billing",
+        "operationId": "codespaces/set-codespaces-access",
         "externalDocs": {
           "description": "API method documentation",
           "url": "https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces"
@@ -7803,17 +7803,17 @@
         }
       }
     },
-    "/orgs/{org}/codespaces/billing/selected_users": {
+    "/orgs/{org}/codespaces/access/selected_users": {
       "post": {
-        "summary": "Add users to Codespaces billing for an organization",
-        "description": "Codespaces for the specified users will be billed to the organization.\n\nTo use this endpoint, the billing settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
+        "summary": "Add users to Codespaces access for an organization",
+        "description": "Codespaces for the specified users will be billed to the organization.\n\nTo use this endpoint, the access settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
         "tags": [
           "codespaces"
         ],
-        "operationId": "codespaces/set-codespaces-billing-users",
+        "operationId": "codespaces/set-codespaces-access-users",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/codespaces/organizations#add-users-to-codespaces-billing-for-an-organization"
+          "url": "https://docs.github.com/rest/codespaces/organizations#add-users-to-codespaces-access-for-an-organization"
         },
         "parameters": [
           {
@@ -7882,15 +7882,15 @@
         }
       },
       "delete": {
-        "summary": "Remove users from Codespaces billing for an organization",
-        "description": "Codespaces for the specified users will no longer be billed to the organization.\n\nTo use this endpoint, the billing settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
+        "summary": "Remove users from Codespaces access for an organization",
+        "description": "Codespaces for the specified users will no longer be billed to the organization.\n\nTo use this endpoint, the access settings for the organization must be set to `selected_members`.\nFor information on how to change this setting, see \"[Manage access control for organization codespaces](https://docs.github.com/rest/codespaces/organizations#manage-access-control-for-organization-codespaces).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint.",
         "tags": [
           "codespaces"
         ],
-        "operationId": "codespaces/delete-codespaces-billing-users",
+        "operationId": "codespaces/delete-codespaces-access-users",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/codespaces/organizations#remove-users-from-codespaces-billing-for-an-organization"
+          "url": "https://docs.github.com/rest/codespaces/organizations#remove-users-from-codespaces-access-for-an-organization"
         },
         "deprecated": true,
         "parameters": [
@@ -43456,8 +43456,8 @@
                     "type": "string",
                     "description": "The level at which the comment is targeted.",
                     "enum": [
-                      "LINE",
-                      "FILE"
+                      "line",
+                      "file"
                     ]
                   }
                 },
@@ -100816,7 +100816,7 @@
             ]
           },
           "languages": {
-            "description": "CodeQL languages to be analyzed. Supported values are: `c-cpp`, `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, and `ruby`.",
+            "description": "CodeQL languages to be analyzed. Supported values are: `c-cpp`, `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, `ruby`, and `swift`.",
             "type": "array",
             "items": {
               "type": "string",