Merge pull request #4530 from github/openapi-update-d725ae3dca7954897…

…47f86f7805bb55a4d4f85213d2f834f33b5a8c004296952 Update OpenAPI 3.1 Descriptions
github · Feb 13, 2025 · 29b8ca3 · 29b8ca3
2 parents 0fbb23b + f889dae
commit 29b8ca3
Show file tree

Hide file tree

Showing 16 changed files with 156 additions and 188 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
@@ -104808,8 +104808,8 @@
           "key"
         ]
       },
-      "copilot-seat-breakdown": {
-        "title": "Copilot Business Seat Breakdown",
+      "copilot-organization-seat-breakdown": {
+        "title": "Copilot Seat Breakdown",
         "description": "The breakdown of Copilot Business seats for the organization.",
         "type": "object",
         "properties": {
@@ -104827,7 +104827,7 @@
           },
           "pending_invitation": {
             "type": "integer",
-            "description": "The number of seats that have been assigned to users that have not yet accepted an invitation to this organization."
+            "description": "The number of users who have been invited to receive a Copilot seat through this organization."
           },
           "active_this_cycle": {
             "type": "integer",
@@ -104845,21 +104845,20 @@
         "type": "object",
         "properties": {
           "seat_breakdown": {
-            "$ref": "#/components/schemas/copilot-seat-breakdown"
+            "$ref": "#/components/schemas/copilot-organization-seat-breakdown"
           },
           "public_code_suggestions": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing Copilot to make suggestions that match public code.",
+            "description": "The organization policy for allowing or blocking suggestions matching public code (duplication detection filter).",
             "enum": [
               "allow",
               "block",
-              "unconfigured",
-              "unknown"
+              "unconfigured"
             ]
           },
           "ide_chat": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing organization members to use Copilot Chat within their editor.",
+            "description": "The organization policy for allowing or disallowing Copilot Chat in the IDE.",
             "enum": [
               "enabled",
               "disabled",
@@ -104868,7 +104867,7 @@
           },
           "platform_chat": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing organization members to use Copilot features within github.com.",
+            "description": "The organization policy for allowing or disallowing Copilot features on GitHub.com.",
             "enum": [
               "enabled",
               "disabled",
@@ -104877,7 +104876,7 @@
           },
           "cli": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing organization members to use Copilot within their CLI.",
+            "description": "The organization policy for allowing or disallowing Copilot in the CLI.",
             "enum": [
               "enabled",
               "disabled",
@@ -104899,8 +104898,7 @@
             "description": "The Copilot plan of the organization, or the parent enterprise, when applicable.",
             "enum": [
               "business",
-              "enterprise",
-              "unknown"
+              "enterprise"
             ]
           }
         },

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
@@ -75948,8 +75948,8 @@ components:
       required:
       - key_id
       - key
-    copilot-seat-breakdown:
-      title: Copilot Business Seat Breakdown
+    copilot-organization-seat-breakdown:
+      title: Copilot Seat Breakdown
       description: The breakdown of Copilot Business seats for the organization.
       type: object
       properties:
@@ -75966,8 +75966,8 @@ components:
             of the current billing cycle.
         pending_invitation:
           type: integer
-          description: The number of seats that have been assigned to users that have
-            not yet accepted an invitation to this organization.
+          description: The number of users who have been invited to receive a Copilot
+            seat through this organization.
         active_this_cycle:
           type: integer
           description: The number of seats that have used Copilot during the current
@@ -75983,36 +75983,35 @@ components:
       type: object
       properties:
         seat_breakdown:
-          "$ref": "#/components/schemas/copilot-seat-breakdown"
+          "$ref": "#/components/schemas/copilot-organization-seat-breakdown"
         public_code_suggestions:
           type: string
-          description: The organization policy for allowing or disallowing Copilot
-            to make suggestions that match public code.
+          description: The organization policy for allowing or blocking suggestions
+            matching public code (duplication detection filter).
           enum:
           - allow
           - block
           - unconfigured
-          - unknown
         ide_chat:
           type: string
-          description: The organization policy for allowing or disallowing organization
-            members to use Copilot Chat within their editor.
+          description: The organization policy for allowing or disallowing Copilot
+            Chat in the IDE.
           enum:
           - enabled
           - disabled
           - unconfigured
         platform_chat:
           type: string
-          description: The organization policy for allowing or disallowing organization
-            members to use Copilot features within github.com.
+          description: The organization policy for allowing or disallowing Copilot
+            features on GitHub.com.
           enum:
           - enabled
           - disabled
           - unconfigured
         cli:
           type: string
-          description: The organization policy for allowing or disallowing organization
-            members to use Copilot within their CLI.
+          description: The organization policy for allowing or disallowing Copilot
+            in the CLI.
           enum:
           - enabled
           - disabled
@@ -76032,7 +76031,6 @@ components:
           enum:
           - business
           - enterprise
-          - unknown
       required:
       - seat_breakdown
       - public_code_suggestions

diff --git a/descriptions-next/api.github.com/api.github.com.json b/descriptions-next/api.github.com/api.github.com.json
@@ -104808,8 +104808,8 @@
           "key"
         ]
       },
-      "copilot-seat-breakdown": {
-        "title": "Copilot Business Seat Breakdown",
+      "copilot-organization-seat-breakdown": {
+        "title": "Copilot Seat Breakdown",
         "description": "The breakdown of Copilot Business seats for the organization.",
         "type": "object",
         "properties": {
@@ -104827,7 +104827,7 @@
           },
           "pending_invitation": {
             "type": "integer",
-            "description": "The number of seats that have been assigned to users that have not yet accepted an invitation to this organization."
+            "description": "The number of users who have been invited to receive a Copilot seat through this organization."
           },
           "active_this_cycle": {
             "type": "integer",
@@ -104845,21 +104845,20 @@
         "type": "object",
         "properties": {
           "seat_breakdown": {
-            "$ref": "#/components/schemas/copilot-seat-breakdown"
+            "$ref": "#/components/schemas/copilot-organization-seat-breakdown"
           },
           "public_code_suggestions": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing Copilot to make suggestions that match public code.",
+            "description": "The organization policy for allowing or blocking suggestions matching public code (duplication detection filter).",
             "enum": [
               "allow",
               "block",
-              "unconfigured",
-              "unknown"
+              "unconfigured"
             ]
           },
           "ide_chat": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing organization members to use Copilot Chat within their editor.",
+            "description": "The organization policy for allowing or disallowing Copilot Chat in the IDE.",
             "enum": [
               "enabled",
               "disabled",
@@ -104868,7 +104867,7 @@
           },
           "platform_chat": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing organization members to use Copilot features within github.com.",
+            "description": "The organization policy for allowing or disallowing Copilot features on GitHub.com.",
             "enum": [
               "enabled",
               "disabled",
@@ -104877,7 +104876,7 @@
           },
           "cli": {
             "type": "string",
-            "description": "The organization policy for allowing or disallowing organization members to use Copilot within their CLI.",
+            "description": "The organization policy for allowing or disallowing Copilot in the CLI.",
             "enum": [
               "enabled",
               "disabled",
@@ -104899,8 +104898,7 @@
             "description": "The Copilot plan of the organization, or the parent enterprise, when applicable.",
             "enum": [
               "business",
-              "enterprise",
-              "unknown"
+              "enterprise"
             ]
           }
         },

diff --git a/descriptions-next/api.github.com/api.github.com.yaml b/descriptions-next/api.github.com/api.github.com.yaml
@@ -75948,8 +75948,8 @@ components:
       required:
       - key_id
       - key
-    copilot-seat-breakdown:
-      title: Copilot Business Seat Breakdown
+    copilot-organization-seat-breakdown:
+      title: Copilot Seat Breakdown
       description: The breakdown of Copilot Business seats for the organization.
       type: object
       properties:
@@ -75966,8 +75966,8 @@ components:
             of the current billing cycle.
         pending_invitation:
           type: integer
-          description: The number of seats that have been assigned to users that have
-            not yet accepted an invitation to this organization.
+          description: The number of users who have been invited to receive a Copilot
+            seat through this organization.
         active_this_cycle:
           type: integer
           description: The number of seats that have used Copilot during the current
@@ -75983,36 +75983,35 @@ components:
       type: object
       properties:
         seat_breakdown:
-          "$ref": "#/components/schemas/copilot-seat-breakdown"
+          "$ref": "#/components/schemas/copilot-organization-seat-breakdown"
         public_code_suggestions:
           type: string
-          description: The organization policy for allowing or disallowing Copilot
-            to make suggestions that match public code.
+          description: The organization policy for allowing or blocking suggestions
+            matching public code (duplication detection filter).
           enum:
           - allow
           - block
           - unconfigured
-          - unknown
         ide_chat:
           type: string
-          description: The organization policy for allowing or disallowing organization
-            members to use Copilot Chat within their editor.
+          description: The organization policy for allowing or disallowing Copilot
+            Chat in the IDE.
           enum:
           - enabled
           - disabled
           - unconfigured
         platform_chat:
           type: string
-          description: The organization policy for allowing or disallowing organization
-            members to use Copilot features within github.com.
+          description: The organization policy for allowing or disallowing Copilot
+            features on GitHub.com.
           enum:
           - enabled
           - disabled
           - unconfigured
         cli:
           type: string
-          description: The organization policy for allowing or disallowing organization
-            members to use Copilot within their CLI.
+          description: The organization policy for allowing or disallowing Copilot
+            in the CLI.
           enum:
           - enabled
           - disabled
@@ -76032,7 +76031,6 @@ components:
           enum:
           - business
           - enterprise
-          - unknown
       required:
       - seat_breakdown
       - public_code_suggestions