Update OpenAPI 3.0 Descriptions

Author: github-openapi-bot

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

@@ -28287,7 +28287,7 @@
     "/orgs/{org}/insights/api/route-stats/{actor_type}/{actor_id}": {
       "get": {
         "summary": "Get route stats by actor",
-        "description": "Get API request count statistics for an actor broken down by route within a specified time frame.",
+        "description": "Get API request count statistics for an actor broken down by route within a specified time frame.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28355,7 +28355,7 @@
     "/orgs/{org}/insights/api/subject-stats": {
       "get": {
         "summary": "Get subject stats",
-        "description": "Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.",
+        "description": "Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28417,7 +28417,7 @@
     "/orgs/{org}/insights/api/summary-stats": {
       "get": {
         "summary": "Get summary stats",
-        "description": "Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.",
+        "description": "Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28464,7 +28464,7 @@
     "/orgs/{org}/insights/api/summary-stats/users/{user_id}": {
       "get": {
         "summary": "Get summary stats by user",
-        "description": "Get overall statistics of API requests within the organization for a user.",
+        "description": "Get overall statistics of API requests within the organization for a user.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28514,7 +28514,7 @@
     "/orgs/{org}/insights/api/summary-stats/{actor_type}/{actor_id}": {
       "get": {
         "summary": "Get summary stats by actor",
-        "description": "Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.",
+        "description": "Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28567,7 +28567,7 @@
     "/orgs/{org}/insights/api/time-stats": {
       "get": {
         "summary": "Get time stats",
-        "description": "Get the number of API requests and rate-limited requests made within an organization over a specified time period.",
+        "description": "Get the number of API requests and rate-limited requests made within an organization over a specified time period.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28617,7 +28617,7 @@
     "/orgs/{org}/insights/api/time-stats/users/{user_id}": {
       "get": {
         "summary": "Get time stats by user",
-        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.",
+        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28670,7 +28670,7 @@
     "/orgs/{org}/insights/api/time-stats/{actor_type}/{actor_id}": {
       "get": {
         "summary": "Get time stats by actor",
-        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.",
+        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28726,7 +28726,7 @@
     "/orgs/{org}/insights/api/user-stats/{user_id}": {
       "get": {
         "summary": "Get user stats",
-        "description": "Get API usage statistics within an organization for a user broken down by the type of access.",
+        "description": "Get API usage statistics within an organization for a user broken down by the type of access.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -66259,6 +66259,7 @@
                 "approved",
                 "dismissed",
                 "replaced",
+                "invalidated",
                 "all"
               ],
               "default": "pending"
@@ -148685,7 +148686,8 @@
               "applied",
               "approved",
               "dismissed",
-              "replaced"
+              "replaced",
+              "invalidated"
             ]
           },
           "target_id": {

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

@@ -21143,8 +21143,10 @@ paths:
   "/orgs/{org}/insights/api/route-stats/{actor_type}/{actor_id}":
     get:
       summary: Get route stats by actor
-      description: Get API request count statistics for an actor broken down by route
-        within a specified time frame.
+      description: |-
+        Get API request count statistics for an actor broken down by route within a specified time frame.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-route-stats-by-actor
@@ -21179,8 +21181,10 @@ paths:
   "/orgs/{org}/insights/api/subject-stats":
     get:
       summary: Get subject stats
-      description: Get API request statistics for all subjects within an organization
-        within a specified time frame. Subjects can be users or GitHub Apps.
+      description: |-
+        Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-subject-stats
@@ -21213,8 +21217,10 @@ paths:
   "/orgs/{org}/insights/api/summary-stats":
     get:
       summary: Get summary stats
-      description: Get overall statistics of API requests made within an organization
-        by all users and apps within a specified time frame.
+      description: |-
+        Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-summary-stats
@@ -21242,8 +21248,10 @@ paths:
   "/orgs/{org}/insights/api/summary-stats/users/{user_id}":
     get:
       summary: Get summary stats by user
-      description: Get overall statistics of API requests within the organization
-        for a user.
+      description: |-
+        Get overall statistics of API requests within the organization for a user.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-summary-stats-by-user
@@ -21272,9 +21280,10 @@ paths:
   "/orgs/{org}/insights/api/summary-stats/{actor_type}/{actor_id}":
     get:
       summary: Get summary stats by actor
-      description: Get overall statistics of API requests within the organization
-        made by a specific actor. Actors can be GitHub App installations, OAuth apps
-        or other tokens on behalf of a user.
+      description: |-
+        Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-summary-stats-by-actor
@@ -21304,8 +21313,10 @@ paths:
   "/orgs/{org}/insights/api/time-stats":
     get:
       summary: Get time stats
-      description: Get the number of API requests and rate-limited requests made within
-        an organization over a specified time period.
+      description: |-
+        Get the number of API requests and rate-limited requests made within an organization over a specified time period.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-time-stats
@@ -21334,8 +21345,10 @@ paths:
   "/orgs/{org}/insights/api/time-stats/users/{user_id}":
     get:
       summary: Get time stats by user
-      description: Get the number of API requests and rate-limited requests made within
-        an organization by a specific user over a specified time period.
+      description: |-
+        Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-time-stats-by-user
@@ -21365,8 +21378,10 @@ paths:
   "/orgs/{org}/insights/api/time-stats/{actor_type}/{actor_id}":
     get:
       summary: Get time stats by actor
-      description: Get the number of API requests and rate-limited requests made within
-        an organization by a specific actor within a specified time period.
+      description: |-
+        Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-time-stats-by-actor
@@ -21397,8 +21412,10 @@ paths:
   "/orgs/{org}/insights/api/user-stats/{user_id}":
     get:
       summary: Get user stats
-      description: Get API usage statistics within an organization for a user broken
-        down by the type of access.
+      description: |-
+        Get API usage statistics within an organization for a user broken down by the type of access.
+
+        Under normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.
       tags:
       - orgs
       operationId: api-insights/get-user-stats
@@ -48792,6 +48809,7 @@ paths:
           - approved
           - dismissed
           - replaced
+          - invalidated
           - all
           default: pending
       - name: action
@@ -110006,6 +110024,7 @@ components:
           - approved
           - dismissed
           - replaced
+          - invalidated
         target_id:
           type: integer
           description: The identifier of the target the change applies to (issue type,

descriptions/api.github.com/api.github.com.2026-03-10.json

@@ -28240,7 +28240,7 @@
     "/orgs/{org}/insights/api/route-stats/{actor_type}/{actor_id}": {
       "get": {
         "summary": "Get route stats by actor",
-        "description": "Get API request count statistics for an actor broken down by route within a specified time frame.",
+        "description": "Get API request count statistics for an actor broken down by route within a specified time frame.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28308,7 +28308,7 @@
     "/orgs/{org}/insights/api/subject-stats": {
       "get": {
         "summary": "Get subject stats",
-        "description": "Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.",
+        "description": "Get API request statistics for all subjects within an organization within a specified time frame. Subjects can be users or GitHub Apps.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28370,7 +28370,7 @@
     "/orgs/{org}/insights/api/summary-stats": {
       "get": {
         "summary": "Get summary stats",
-        "description": "Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.",
+        "description": "Get overall statistics of API requests made within an organization by all users and apps within a specified time frame.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28417,7 +28417,7 @@
     "/orgs/{org}/insights/api/summary-stats/users/{user_id}": {
       "get": {
         "summary": "Get summary stats by user",
-        "description": "Get overall statistics of API requests within the organization for a user.",
+        "description": "Get overall statistics of API requests within the organization for a user.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28467,7 +28467,7 @@
     "/orgs/{org}/insights/api/summary-stats/{actor_type}/{actor_id}": {
       "get": {
         "summary": "Get summary stats by actor",
-        "description": "Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.",
+        "description": "Get overall statistics of API requests within the organization made by a specific actor. Actors can be GitHub App installations, OAuth apps or other tokens on behalf of a user.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28520,7 +28520,7 @@
     "/orgs/{org}/insights/api/time-stats": {
       "get": {
         "summary": "Get time stats",
-        "description": "Get the number of API requests and rate-limited requests made within an organization over a specified time period.",
+        "description": "Get the number of API requests and rate-limited requests made within an organization over a specified time period.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28570,7 +28570,7 @@
     "/orgs/{org}/insights/api/time-stats/users/{user_id}": {
       "get": {
         "summary": "Get time stats by user",
-        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.",
+        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific user over a specified time period.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28623,7 +28623,7 @@
     "/orgs/{org}/insights/api/time-stats/{actor_type}/{actor_id}": {
       "get": {
         "summary": "Get time stats by actor",
-        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.",
+        "description": "Get the number of API requests and rate-limited requests made within an organization by a specific actor within a specified time period.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -28679,7 +28679,7 @@
     "/orgs/{org}/insights/api/user-stats/{user_id}": {
       "get": {
         "summary": "Get user stats",
-        "description": "Get API usage statistics within an organization for a user broken down by the type of access.",
+        "description": "Get API usage statistics within an organization for a user broken down by the type of access.\n\nUnder normal conditions, you can expect API data to appear within 4–6 hours after making a request. During incidents or periods of unusually high volume, it may take longer to show up.",
         "tags": [
           "orgs"
         ],
@@ -66176,6 +66176,7 @@
                 "approved",
                 "dismissed",
                 "replaced",
+                "invalidated",
                 "all"
               ],
               "default": "pending"
@@ -148110,7 +148111,8 @@
               "applied",
               "approved",
               "dismissed",
-              "replaced"
+              "replaced",
+              "invalidated"
             ]
           },
           "target_id": {