Update OpenAPI 3.0 Descriptions

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

@@ -13291,7 +13291,7 @@
     "/orgs/{org}/copilot/usage": {
       "get": {
         "summary": "Get a summary of Copilot usage for organization members",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nacross an organization, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\nOrganization owners, and owners and billing managers of the parent enterprise, can view Copilot usage metrics.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
+        "description": "> [!NOTE]\n> This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nacross an organization, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\nOrganization owners, and owners and billing managers of the parent enterprise, can view Copilot usage metrics.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
         "tags": [
           "copilot"
         ],
@@ -21865,7 +21865,7 @@
     "/orgs/{org}/team/{team_slug}/copilot/usage": {
       "get": {
         "summary": "Get a summary of Copilot usage for a team",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nfor users within a team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\n> [!NOTE]\n> This endpoint will only return results for a given day if the team had five or more members with active Copilot licenses, as evaluated at the end of that day.\n\nOrganization owners for the organization that contains this team, and owners and billing managers of the parent enterprise can view Copilot usage metrics for a team.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
+        "description": "> [!NOTE]\n> This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nfor users within a team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\n> [!NOTE]\n> This endpoint will only return results for a given day if the team had five or more members with active Copilot licenses, as evaluated at the end of that day.\n\nOrganization owners for the organization that contains this team, and owners and billing managers of the parent enterprise can view Copilot usage metrics for a team.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
         "tags": [
           "copilot"
         ],

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

@@ -9699,7 +9699,7 @@ paths:
       summary: Get a summary of Copilot usage for organization members
       description: |-
         > [!NOTE]
-        > This endpoint is in public preview and is subject to change.
+        > This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.
 
         You can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE
         across an organization, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.
@@ -15855,7 +15855,7 @@ paths:
       summary: Get a summary of Copilot usage for a team
       description: |-
         > [!NOTE]
-        > This endpoint is in public preview and is subject to change.
+        > This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.
 
         You can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE
         for users within a team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.

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

@@ -13291,7 +13291,7 @@
     "/orgs/{org}/copilot/usage": {
       "get": {
         "summary": "Get a summary of Copilot usage for organization members",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nacross an organization, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\nOrganization owners, and owners and billing managers of the parent enterprise, can view Copilot usage metrics.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
+        "description": "> [!NOTE]\n> This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nacross an organization, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\nOrganization owners, and owners and billing managers of the parent enterprise, can view Copilot usage metrics.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
         "tags": [
           "copilot"
         ],
@@ -21865,7 +21865,7 @@
     "/orgs/{org}/team/{team_slug}/copilot/usage": {
       "get": {
         "summary": "Get a summary of Copilot usage for a team",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nfor users within a team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\n> [!NOTE]\n> This endpoint will only return results for a given day if the team had five or more members with active Copilot licenses, as evaluated at the end of that day.\n\nOrganization owners for the organization that contains this team, and owners and billing managers of the parent enterprise can view Copilot usage metrics for a team.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
+        "description": "> [!NOTE]\n> This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.\n\nYou can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nfor users within a team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.\n\nThe response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.\n\n> [!NOTE]\n> This endpoint will only return results for a given day if the team had five or more members with active Copilot licenses, as evaluated at the end of that day.\n\nOrganization owners for the organization that contains this team, and owners and billing managers of the parent enterprise can view Copilot usage metrics for a team.\n\nOAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot`, `read:org`, or `read:enterprise` scopes to use this endpoint.",
         "tags": [
           "copilot"
         ],

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

@@ -9699,7 +9699,7 @@ paths:
       summary: Get a summary of Copilot usage for organization members
       description: |-
         > [!NOTE]
-        > This endpoint is in public preview and is subject to change.
+        > This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.
 
         You can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE
         across an organization, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.
@@ -15855,7 +15855,7 @@ paths:
       summary: Get a summary of Copilot usage for a team
       description: |-
         > [!NOTE]
-        > This endpoint is in public preview and is subject to change.
+        > This endpoint is closing down. It will be accessible throughout February 2025, but will not return any new data after February 1st.
 
         You can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE
         for users within a team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.