Merge pull request #19006 from github/repo-sync

repo sync

Author: Octomerger

lib/rest/static/decorated/api.github.com.json

@@ -175275,7 +175275,7 @@
           },
           {
             "name": "state",
-            "description": "<p>Set to <code>open</code>, <code>closed</code>, <code>fixed</code>, or <code>dismissed</code> to list code scanning alerts in a specific state.</p>",
+            "description": "<p>If specified, only code scanning alerts with this state will be returned.</p>",
             "in": "query",
             "required": false,
             "schema": {
@@ -176565,7 +176565,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all code scanning alerts for the default branch (usually <code>main</code>\nor <code>master</code>) for all eligible repositories in an organization.\nTo use this endpoint, you must be an administrator or security manager for the organization, and you must use an access token with the <code>repo</code> scope or <code>security_events</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read permission to use this endpoint.</p>",
+        "descriptionHTML": "<p>Lists code scanning alerts for the default branch for all eligible repositories in an organization. Eligible repositories are repositories that are owned by organizations that you own or for which you are a security manager. For more information, see \"<a href=\"https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security managers in your organization</a>.\"</p>\n<p>To use this endpoint, you must be an owner or security manager for the organization, and you must use an access token with the <code>repo</code> scope or <code>security_events</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read permission to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
@@ -176692,7 +176692,7 @@
           },
           {
             "name": "state",
-            "description": "<p>Set to <code>open</code>, <code>closed</code>, <code>fixed</code>, or <code>dismissed</code> to list code scanning alerts in a specific state.</p>",
+            "description": "<p>If specified, only code scanning alerts with this state will be returned.</p>",
             "in": "query",
             "required": false,
             "schema": {
@@ -177268,7 +177268,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all open code scanning alerts for the default branch (usually <code>main</code>\nor <code>master</code>). You must use an access token with the <code>security_events</code> scope to use\nthis endpoint with private repos, the <code>public_repo</code> scope also grants permission to read\nsecurity events on public repos only. GitHub Apps must have the <code>security_events</code> read\npermission to use this endpoint.</p>\n<p>The response includes a <code>most_recent_instance</code> object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used <code>ref</code> in the request).</p>",
+        "descriptionHTML": "<p>Lists code scanning alerts.</p>\n<p>To use this endpoint, you must use an access token with the <code>security_events</code> scope or, for alerts from public repositories only, an access token with the <code>public_repo</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read\npermission to use this endpoint.</p>\n<p>The response includes a <code>most_recent_instance</code> object.\nThis provides details of the most recent instance of this alert\nfor the default branch (or for the specified Git reference if you used <code>ref</code> in the request).</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",

lib/rest/static/decorated/ghes-3.4.json

@@ -161539,7 +161539,7 @@
           },
           {
             "name": "state",
-            "description": "<p>Set to <code>open</code>, <code>closed</code>, <code>fixed</code>, or <code>dismissed</code> to list code scanning alerts in a specific state.</p>",
+            "description": "<p>If specified, only code scanning alerts with this state will be returned.</p>",
             "in": "query",
             "required": false,
             "schema": {
@@ -162105,7 +162105,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all open code scanning alerts for the default branch (usually <code>main</code>\nor <code>master</code>). You must use an access token with the <code>security_events</code> scope to use\nthis endpoint with private repos, the <code>public_repo</code> scope also grants permission to read\nsecurity events on public repos only. GitHub Apps must have the <code>security_events</code> read\npermission to use this endpoint.</p>\n<p>The response includes a <code>most_recent_instance</code> object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used <code>ref</code> in the request).</p>",
+        "descriptionHTML": "<p>Lists code scanning alerts.</p>\n<p>To use this endpoint, you must use an access token with the <code>security_events</code> scope or, for alerts from public repositories only, an access token with the <code>public_repo</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read\npermission to use this endpoint.</p>\n<p>The response includes a <code>most_recent_instance</code> object.\nThis provides details of the most recent instance of this alert\nfor the default branch (or for the specified Git reference if you used <code>ref</code> in the request).</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",

lib/rest/static/decorated/ghes-3.5.json

@@ -170064,7 +170064,7 @@
           },
           {
             "name": "state",
-            "description": "<p>Set to <code>open</code>, <code>closed</code>, <code>fixed</code>, or <code>dismissed</code> to list code scanning alerts in a specific state.</p>",
+            "description": "<p>If specified, only code scanning alerts with this state will be returned.</p>",
             "in": "query",
             "required": false,
             "schema": {
@@ -171344,7 +171344,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all code scanning alerts for the default branch (usually <code>main</code>\nor <code>master</code>) for all eligible repositories in an organization.\nTo use this endpoint, you must be an administrator or security manager for the organization, and you must use an access token with the <code>repo</code> scope or <code>security_events</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read permission to use this endpoint.</p>",
+        "descriptionHTML": "<p>Lists code scanning alerts for the default branch for all eligible repositories in an organization. Eligible repositories are repositories that are owned by organizations that you own or for which you are a security manager. For more information, see \"<a href=\"https://docs.github.com/[email protected]/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security managers in your organization</a>.\"</p>\n<p>To use this endpoint, you must be an owner or security manager for the organization, and you must use an access token with the <code>repo</code> scope or <code>security_events</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read permission to use this endpoint.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
@@ -171471,7 +171471,7 @@
           },
           {
             "name": "state",
-            "description": "<p>Set to <code>open</code>, <code>closed</code>, <code>fixed</code>, or <code>dismissed</code> to list code scanning alerts in a specific state.</p>",
+            "description": "<p>If specified, only code scanning alerts with this state will be returned.</p>",
             "in": "query",
             "required": false,
             "schema": {
@@ -172037,7 +172037,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Lists all open code scanning alerts for the default branch (usually <code>main</code>\nor <code>master</code>). You must use an access token with the <code>security_events</code> scope to use\nthis endpoint with private repos, the <code>public_repo</code> scope also grants permission to read\nsecurity events on public repos only. GitHub Apps must have the <code>security_events</code> read\npermission to use this endpoint.</p>\n<p>The response includes a <code>most_recent_instance</code> object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used <code>ref</code> in the request).</p>",
+        "descriptionHTML": "<p>Lists code scanning alerts.</p>\n<p>To use this endpoint, you must use an access token with the <code>security_events</code> scope or, for alerts from public repositories only, an access token with the <code>public_repo</code> scope.</p>\n<p>GitHub Apps must have the <code>security_events</code> read\npermission to use this endpoint.</p>\n<p>The response includes a <code>most_recent_instance</code> object.\nThis provides details of the most recent instance of this alert\nfor the default branch (or for the specified Git reference if you used <code>ref</code> in the request).</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",

lib/rest/static/dereferenced/api.github.com.deref.json

@@ -80939,7 +80939,7 @@
     "/orgs/{org}/code-scanning/alerts": {
       "get": {
         "summary": "List code scanning alerts for an organization",
-        "description": "Lists all code scanning alerts for the default branch (usually `main`\nor `master`) for all eligible repositories in an organization.\nTo use this endpoint, you must be an administrator or security manager for the organization, and you must use an access token with the `repo` scope or `security_events` scope.\n\nGitHub Apps must have the `security_events` read permission to use this endpoint.",
+        "description": "Lists code scanning alerts for the default branch for all eligible repositories in an organization. Eligible repositories are repositories that are owned by organizations that you own or for which you are a security manager. For more information, see \"[Managing security managers in your organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization).\"\n\nTo use this endpoint, you must be an owner or security manager for the organization, and you must use an access token with the `repo` scope or `security_events` scope.\n\nGitHub Apps must have the `security_events` read permission to use this endpoint.",
         "tags": [
           "code-scanning"
         ],
@@ -81033,7 +81033,7 @@
           },
           {
             "name": "state",
-            "description": "Set to `open`, `closed`, `fixed`, or `dismissed` to list code scanning alerts in a specific state.",
+            "description": "If specified, only code scanning alerts with this state will be returned.",
             "in": "query",
             "required": false,
             "schema": {
@@ -241476,7 +241476,7 @@
     "/repos/{owner}/{repo}/code-scanning/alerts": {
       "get": {
         "summary": "List code scanning alerts for a repository",
-        "description": "Lists all open code scanning alerts for the default branch (usually `main`\nor `master`). You must use an access token with the `security_events` scope to use\nthis endpoint with private repos, the `public_repo` scope also grants permission to read\nsecurity events on public repos only. GitHub Apps must have the `security_events` read\npermission to use this endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch or for the specified Git reference\n(if you used `ref` in the request).",
+        "description": "Lists code scanning alerts.\n\nTo use this endpoint, you must use an access token with the `security_events` scope or, for alerts from public repositories only, an access token with the `public_repo` scope.\n\nGitHub Apps must have the `security_events` read\npermission to use this endpoint.\n\nThe response includes a `most_recent_instance` object.\nThis provides details of the most recent instance of this alert\nfor the default branch (or for the specified Git reference if you used `ref` in the request).",
         "tags": [
           "code-scanning"
         ],
@@ -241585,7 +241585,7 @@
           },
           {
             "name": "state",
-            "description": "Set to `open`, `closed`, `fixed`, or `dismissed` to list code scanning alerts in a specific state.",
+            "description": "If specified, only code scanning alerts with this state will be returned.",
             "in": "query",
             "required": false,
             "schema": {