diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.json b/descriptions/api.github.com/api.github.com.2022-11-28.json index a5af04dfde..e8f8731240 100644 --- a/descriptions/api.github.com/api.github.com.2022-11-28.json +++ b/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": { diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.yaml b/descriptions/api.github.com/api.github.com.2022-11-28.yaml index 5601695fb0..fe1878f2ee 100644 --- a/descriptions/api.github.com/api.github.com.2022-11-28.yaml +++ b/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, diff --git a/descriptions/api.github.com/api.github.com.2026-03-10.json b/descriptions/api.github.com/api.github.com.2026-03-10.json index 5335f3f76d..7841c6c55a 100644 --- a/descriptions/api.github.com/api.github.com.2026-03-10.json +++ b/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": { diff --git a/descriptions/api.github.com/api.github.com.2026-03-10.yaml b/descriptions/api.github.com/api.github.com.2026-03-10.yaml index a14c2a6530..0f8e84b73a 100644 --- a/descriptions/api.github.com/api.github.com.2026-03-10.yaml +++ b/descriptions/api.github.com/api.github.com.2026-03-10.yaml @@ -21108,8 +21108,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 @@ -21144,8 +21146,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 @@ -21178,8 +21182,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 @@ -21207,8 +21213,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 @@ -21237,9 +21245,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 @@ -21269,8 +21278,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 @@ -21299,8 +21310,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 @@ -21330,8 +21343,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 @@ -21362,8 +21377,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 @@ -48720,6 +48737,7 @@ paths: - approved - dismissed - replaced + - invalidated - all default: pending - name: action @@ -109549,6 +109567,7 @@ components: - approved - dismissed - replaced + - invalidated target_id: type: integer description: The identifier of the target the change applies to (issue type, diff --git a/descriptions/api.github.com/api.github.com.json b/descriptions/api.github.com/api.github.com.json index 7a54434ecf..c439288716 100644 --- a/descriptions/api.github.com/api.github.com.json +++ b/descriptions/api.github.com/api.github.com.json @@ -28404,7 +28404,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" ], @@ -28472,7 +28472,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" ], @@ -28534,7 +28534,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" ], @@ -28581,7 +28581,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" ], @@ -28631,7 +28631,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" ], @@ -28684,7 +28684,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" ], @@ -28734,7 +28734,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" ], @@ -28787,7 +28787,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" ], @@ -28843,7 +28843,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" ], @@ -66566,6 +66566,7 @@ "approved", "dismissed", "replaced", + "invalidated", "all" ], "default": "pending" @@ -149895,7 +149896,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { diff --git a/descriptions/api.github.com/api.github.com.yaml b/descriptions/api.github.com/api.github.com.yaml index 504f985f1e..7df3a642d1 100644 --- a/descriptions/api.github.com/api.github.com.yaml +++ b/descriptions/api.github.com/api.github.com.yaml @@ -21205,8 +21205,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 @@ -21241,8 +21243,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 @@ -21275,8 +21279,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 @@ -21304,8 +21310,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 @@ -21334,9 +21342,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 @@ -21366,8 +21375,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 @@ -21396,8 +21407,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 @@ -21427,8 +21440,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 @@ -21459,8 +21474,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 @@ -48980,6 +48997,7 @@ paths: - approved - dismissed - replaced + - invalidated - all default: pending - name: action @@ -110865,6 +110883,7 @@ components: - approved - dismissed - replaced + - invalidated target_id: type: integer description: The identifier of the target the change applies to (issue type, diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json index 04e44b4e82..ba99bd58ad 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json @@ -147435,7 +147435,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" ], @@ -147628,7 +147628,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" ], @@ -147794,7 +147794,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" ], @@ -147876,7 +147876,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" ], @@ -147967,7 +147967,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" ], @@ -148074,7 +148074,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" ], @@ -148197,7 +148197,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" ], @@ -148329,7 +148329,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" ], @@ -148477,7 +148477,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" ], @@ -486091,6 +486091,7 @@ "approved", "dismissed", "replaced", + "invalidated", "all" ], "default": "pending" @@ -486170,7 +486171,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { @@ -486495,7 +486497,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { @@ -486820,7 +486823,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml index cde4b16294..626c01c6e0 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml @@ -38999,8 +38999,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 @@ -39121,8 +39123,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 @@ -39204,8 +39208,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 @@ -39248,8 +39254,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 @@ -39282,9 +39290,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 @@ -39312,8 +39321,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 @@ -39380,8 +39391,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 @@ -39409,8 +39422,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 @@ -39439,8 +39454,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 @@ -92890,6 +92907,7 @@ paths: - approved - dismissed - replaced + - invalidated - all default: pending - name: action @@ -92944,6 +92962,7 @@ paths: - approved - dismissed - replaced + - invalidated target_id: type: integer description: The identifier of the target the change applies diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json index 99ec83dbaf..cff9e987f3 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json @@ -143670,7 +143670,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" ], @@ -143863,7 +143863,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" ], @@ -144029,7 +144029,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" ], @@ -144111,7 +144111,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" ], @@ -144202,7 +144202,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" ], @@ -144309,7 +144309,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" ], @@ -144432,7 +144432,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" ], @@ -144564,7 +144564,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" ], @@ -144712,7 +144712,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" ], @@ -476659,6 +476659,7 @@ "approved", "dismissed", "replaced", + "invalidated", "all" ], "default": "pending" @@ -476738,7 +476739,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { @@ -477063,7 +477065,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { @@ -477388,7 +477391,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml index 87aedd0b14..75d20b1665 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml @@ -38651,8 +38651,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 @@ -38773,8 +38775,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 @@ -38856,8 +38860,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 @@ -38900,8 +38906,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 @@ -38934,9 +38942,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 @@ -38964,8 +38973,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 @@ -39032,8 +39043,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 @@ -39061,8 +39074,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 @@ -39091,8 +39106,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 @@ -92406,6 +92423,7 @@ paths: - approved - dismissed - replaced + - invalidated - all default: pending - name: action @@ -92460,6 +92478,7 @@ paths: - approved - dismissed - replaced + - invalidated target_id: type: integer description: The identifier of the target the change applies diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json index 243c50d722..36f15e148b 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json @@ -149990,7 +149990,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" ], @@ -150183,7 +150183,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" ], @@ -150349,7 +150349,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" ], @@ -150431,7 +150431,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" ], @@ -150522,7 +150522,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" ], @@ -150629,7 +150629,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" ], @@ -150752,7 +150752,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" ], @@ -150884,7 +150884,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" ], @@ -151032,7 +151032,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" ], @@ -497833,6 +497833,7 @@ "approved", "dismissed", "replaced", + "invalidated", "all" ], "default": "pending" @@ -497912,7 +497913,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { @@ -498237,7 +498239,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { @@ -498562,7 +498565,8 @@ "applied", "approved", "dismissed", - "replaced" + "replaced", + "invalidated" ] }, "target_id": { diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml index 5edffdbc28..203abb1d50 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml @@ -39330,8 +39330,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 @@ -39452,8 +39454,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 @@ -39535,8 +39539,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 @@ -39579,8 +39585,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 @@ -39613,9 +39621,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 @@ -39643,8 +39652,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 @@ -39711,8 +39722,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 @@ -39740,8 +39753,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 @@ -39770,8 +39785,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 @@ -93611,6 +93628,7 @@ paths: - approved - dismissed - replaced + - invalidated - all default: pending - name: action @@ -93665,6 +93683,7 @@ paths: - approved - dismissed - replaced + - invalidated target_id: type: integer description: The identifier of the target the change applies diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json index 783221a021..e7da3e3de4 100644 --- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json +++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json @@ -203742,7 +203742,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" ], @@ -203935,7 +203935,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" ], @@ -204101,7 +204101,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" ], @@ -204183,7 +204183,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" ], @@ -204274,7 +204274,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" ], @@ -204381,7 +204381,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" ], @@ -204504,7 +204504,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" ], @@ -204636,7 +204636,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" ], @@ -204784,7 +204784,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" ], @@ -551053,6 +551053,7 @@ "approved", "dismissed", "replaced", + "invalidated", "all" ], "default": "pending" @@ -551132,7 +551133,8 @@ "applied", "approved", "dismissed", - "replaced" + {"code":"deadline_exceeded","msg":"operation timed out"}