Update OpenAPI Descriptions (github#26779)

Author: github-openapi-bot

lib/rest/static/apps/enabled-for-apps.json

@@ -2549,6 +2549,21 @@
         "verb": "get",
         "requestPath": "/repos/{owner}/{repo}/tags"
       },
+      {
+        "slug": "list-tag-protection-states-for-a-repository",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/tags/protection"
+      },
+      {
+        "slug": "create-a-tag-protection-state-for-a-repository",
+        "verb": "post",
+        "requestPath": "/repos/{owner}/{repo}/tags/protection"
+      },
+      {
+        "slug": "delete-a-tag-protection-state-for-a-repository",
+        "verb": "delete",
+        "requestPath": "/repos/{owner}/{repo}/tags/protection/{tag_protection_id}"
+      },
       {
         "slug": "download-a-repository-archive-tar",
         "verb": "get",

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

@@ -26518,7 +26518,7 @@
             "description": "<p>Validation failed</p>"
           }
         ],
-        "descriptionHTML": "<p>This endpoint triggers <a href=\"https://docs.github.com/en/github/managing-subscriptions-and-notifications-on-github/about-notifications\">notifications</a>. Creating content too quickly using this endpoint may result in secondary rate limiting. See \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#secondary-rate-limits\">Secondary rate limits</a>\" and \"<a href=\"https://docs.github.com/[email protected]/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits\">Dealing with secondary rate limits</a>\" for details.</p>\n<p>For more information on permission levels, see \"<a href=\"https://docs.github.com/en/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization\">Repository permission levels for an organization</a>\". There are restrictions on which permissions can be granted to organization members when an organization base role is in place. In this case, the permission being given must be equal to or higher than the org base permission. Otherwise, the request will fail with:</p>\n<pre><code>Cannot assign {member} permission of {role name}\n</code></pre>\n<p>Note that, if you choose not to pass any parameters, you'll need to set <code>Content-Length</code> to zero when calling out to this endpoint. For more information, see \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#http-verbs\">HTTP verbs</a>.\"</p>\n<p>The invitee will receive a notification that they have been invited to the repository, which they must accept or decline. They may do this via the notifications page, the email they receive, or by using the <a href=\"https://docs.github.com/[email protected]/rest/reference/repos#invitations\">repository invitations API endpoints</a>.</p>\n<p><strong>Rate limits</strong></p>\n<p>You are limited to sending 50 invitations to a repository per 24 hour period. Note there is no limit if you are inviting organization members to an organization repository.</p>",
+        "descriptionHTML": "<p>This endpoint triggers <a href=\"https://docs.github.com/[email protected]/github/managing-subscriptions-and-notifications-on-github/about-notifications\">notifications</a>. Creating content too quickly using this endpoint may result in secondary rate limiting. See \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#secondary-rate-limits\">Secondary rate limits</a>\" and \"<a href=\"https://docs.github.com/[email protected]/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits\">Dealing with secondary rate limits</a>\" for details.</p>\n<p>For more information on permission levels, see \"<a href=\"https://docs.github.com/[email protected]/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization\">Repository permission levels for an organization</a>\". There are restrictions on which permissions can be granted to organization members when an organization base role is in place. In this case, the permission being given must be equal to or higher than the org base permission. Otherwise, the request will fail with:</p>\n<pre><code>Cannot assign {member} permission of {role name}\n</code></pre>\n<p>Note that, if you choose not to pass any parameters, you'll need to set <code>Content-Length</code> to zero when calling out to this endpoint. For more information, see \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#http-verbs\">HTTP verbs</a>.\"</p>\n<p>The invitee will receive a notification that they have been invited to the repository, which they must accept or decline. They may do this via the notifications page, the email they receive, or by using the <a href=\"https://docs.github.com/[email protected]/rest/reference/repos#invitations\">repository invitations API endpoints</a>.</p>\n<p><strong>Rate limits</strong></p>\n<p>You are limited to sending 50 invitations to a repository per 24 hour period. Note there is no limit if you are inviting organization members to an organization repository.</p>",
         "bodyParameters": [
           {
             "type": "string",
@@ -34939,10 +34939,16 @@
         "notes": [],
         "descriptionHTML": "",
         "responses": [
+          {
+            "httpStatusCode": "200",
+            "httpStatusMessage": "OK",
+            "description": "<p>Response when getting an existing impersonation OAuth token</p>",
+            "payload": "{\n  \"id\": 1,\n  \"url\": \"https://api.github.com/authorizations/1\",\n  \"scopes\": [\n    \"public_repo\"\n  ],\n  \"token\": \"ghu_16C7e42F292c6912E7710c838347Ae178B4a\",\n  \"token_last_eight\": \"Ae178B4a\",\n  \"hashed_token\": \"25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8\",\n  \"app\": {\n    \"url\": \"http://my-github-app.com\",\n    \"name\": \"my github app\",\n    \"client_id\": \"abcde12345fghij67890\"\n  },\n  \"note\": \"optional note\",\n  \"note_url\": \"http://optional/note/url\",\n  \"updated_at\": \"2011-09-06T20:39:23Z\",\n  \"created_at\": \"2011-09-06T17:26:27Z\",\n  \"fingerprint\": \"jklmnop12345678\"\n}"
+          },
           {
             "httpStatusCode": "201",
             "httpStatusMessage": "Created",
-            "description": "<p>Response</p>",
+            "description": "<p>Response when creating a new impersonation OAuth token</p>",
             "payload": "{\n  \"id\": 1,\n  \"url\": \"https://api.github.com/authorizations/1\",\n  \"scopes\": [\n    \"public_repo\"\n  ],\n  \"token\": \"ghu_16C7e42F292c6912E7710c838347Ae178B4a\",\n  \"token_last_eight\": \"Ae178B4a\",\n  \"hashed_token\": \"25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8\",\n  \"app\": {\n    \"url\": \"http://my-github-app.com\",\n    \"name\": \"my github app\",\n    \"client_id\": \"abcde12345fghij67890\"\n  },\n  \"note\": \"optional note\",\n  \"note_url\": \"http://optional/note/url\",\n  \"updated_at\": \"2011-09-06T20:39:23Z\",\n  \"created_at\": \"2011-09-06T17:26:27Z\",\n  \"fingerprint\": \"jklmnop12345678\"\n}"
           }
         ],
@@ -48074,7 +48080,7 @@
         "subcategory": "outside-collaborators",
         "notes": [],
         "bodyParameters": [],
-        "descriptionHTML": "<p>When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see \"<a href=\"https://docs.github.com/articles/converting-an-organization-member-to-an-outside-collaborator/\">Converting an organization member to an outside collaborator</a>\".</p>",
+        "descriptionHTML": "<p>When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see \"<a href=\"https://docs.github.com/[email protected]/articles/converting-an-organization-member-to-an-outside-collaborator/\">Converting an organization member to an outside collaborator</a>\".</p>",
         "responses": [
           {
             "httpStatusCode": "202",
@@ -48089,7 +48095,7 @@
           {
             "httpStatusCode": "403",
             "httpStatusMessage": "Forbidden",
-            "description": "<p>Forbidden if user is the last owner of the organization or not a member of the organization</p>"
+            "description": "<p>Forbidden if user is the last owner of the organization or not a member of the organization.</p>"
           },
           {
             "httpStatusCode": "404",

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

@@ -27384,7 +27384,7 @@
             "description": "<p>Validation failed</p>"
           }
         ],
-        "descriptionHTML": "<p>This endpoint triggers <a href=\"https://docs.github.com/en/github/managing-subscriptions-and-notifications-on-github/about-notifications\">notifications</a>. Creating content too quickly using this endpoint may result in secondary rate limiting. See \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#secondary-rate-limits\">Secondary rate limits</a>\" and \"<a href=\"https://docs.github.com/[email protected]/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits\">Dealing with secondary rate limits</a>\" for details.</p>\n<p>For more information on permission levels, see \"<a href=\"https://docs.github.com/en/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization\">Repository permission levels for an organization</a>\". There are restrictions on which permissions can be granted to organization members when an organization base role is in place. In this case, the permission being given must be equal to or higher than the org base permission. Otherwise, the request will fail with:</p>\n<pre><code>Cannot assign {member} permission of {role name}\n</code></pre>\n<p>Note that, if you choose not to pass any parameters, you'll need to set <code>Content-Length</code> to zero when calling out to this endpoint. For more information, see \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#http-verbs\">HTTP verbs</a>.\"</p>\n<p>The invitee will receive a notification that they have been invited to the repository, which they must accept or decline. They may do this via the notifications page, the email they receive, or by using the <a href=\"https://docs.github.com/[email protected]/rest/reference/repos#invitations\">repository invitations API endpoints</a>.</p>\n<p><strong>Rate limits</strong></p>\n<p>You are limited to sending 50 invitations to a repository per 24 hour period. Note there is no limit if you are inviting organization members to an organization repository.</p>",
+        "descriptionHTML": "<p>This endpoint triggers <a href=\"https://docs.github.com/[email protected]/github/managing-subscriptions-and-notifications-on-github/about-notifications\">notifications</a>. Creating content too quickly using this endpoint may result in secondary rate limiting. See \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#secondary-rate-limits\">Secondary rate limits</a>\" and \"<a href=\"https://docs.github.com/[email protected]/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits\">Dealing with secondary rate limits</a>\" for details.</p>\n<p>For more information on permission levels, see \"<a href=\"https://docs.github.com/[email protected]/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization\">Repository permission levels for an organization</a>\". There are restrictions on which permissions can be granted to organization members when an organization base role is in place. In this case, the permission being given must be equal to or higher than the org base permission. Otherwise, the request will fail with:</p>\n<pre><code>Cannot assign {member} permission of {role name}\n</code></pre>\n<p>Note that, if you choose not to pass any parameters, you'll need to set <code>Content-Length</code> to zero when calling out to this endpoint. For more information, see \"<a href=\"https://docs.github.com/[email protected]/rest/overview/resources-in-the-rest-api#http-verbs\">HTTP verbs</a>.\"</p>\n<p>The invitee will receive a notification that they have been invited to the repository, which they must accept or decline. They may do this via the notifications page, the email they receive, or by using the <a href=\"https://docs.github.com/[email protected]/rest/reference/repos#invitations\">repository invitations API endpoints</a>.</p>\n<p><strong>Rate limits</strong></p>\n<p>You are limited to sending 50 invitations to a repository per 24 hour period. Note there is no limit if you are inviting organization members to an organization repository.</p>",
         "bodyParameters": [
           {
             "type": "string",
@@ -36258,10 +36258,16 @@
         "notes": [],
         "descriptionHTML": "",
         "responses": [
+          {
+            "httpStatusCode": "200",
+            "httpStatusMessage": "OK",
+            "description": "<p>Response when getting an existing impersonation OAuth token</p>",
+            "payload": "{\n  \"id\": 1,\n  \"url\": \"https://api.github.com/authorizations/1\",\n  \"scopes\": [\n    \"public_repo\"\n  ],\n  \"token\": \"ghu_16C7e42F292c6912E7710c838347Ae178B4a\",\n  \"token_last_eight\": \"Ae178B4a\",\n  \"hashed_token\": \"25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8\",\n  \"app\": {\n    \"url\": \"http://my-github-app.com\",\n    \"name\": \"my github app\",\n    \"client_id\": \"abcde12345fghij67890\"\n  },\n  \"note\": \"optional note\",\n  \"note_url\": \"http://optional/note/url\",\n  \"updated_at\": \"2011-09-06T20:39:23Z\",\n  \"created_at\": \"2011-09-06T17:26:27Z\",\n  \"expires_at\": \"2011-10-06T17:26:27Z\",\n  \"fingerprint\": \"jklmnop12345678\"\n}"
+          },
           {
             "httpStatusCode": "201",
             "httpStatusMessage": "Created",
-            "description": "<p>Response</p>",
+            "description": "<p>Response when creating a new impersonation OAuth token</p>",
             "payload": "{\n  \"id\": 1,\n  \"url\": \"https://api.github.com/authorizations/1\",\n  \"scopes\": [\n    \"public_repo\"\n  ],\n  \"token\": \"ghu_16C7e42F292c6912E7710c838347Ae178B4a\",\n  \"token_last_eight\": \"Ae178B4a\",\n  \"hashed_token\": \"25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8\",\n  \"app\": {\n    \"url\": \"http://my-github-app.com\",\n    \"name\": \"my github app\",\n    \"client_id\": \"abcde12345fghij67890\"\n  },\n  \"note\": \"optional note\",\n  \"note_url\": \"http://optional/note/url\",\n  \"updated_at\": \"2011-09-06T20:39:23Z\",\n  \"created_at\": \"2011-09-06T17:26:27Z\",\n  \"expires_at\": \"2011-10-06T17:26:27Z\",\n  \"fingerprint\": \"jklmnop12345678\"\n}"
           }
         ],
@@ -49393,7 +49399,7 @@
         "subcategory": "outside-collaborators",
         "notes": [],
         "bodyParameters": [],
-        "descriptionHTML": "<p>When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see \"<a href=\"https://docs.github.com/articles/converting-an-organization-member-to-an-outside-collaborator/\">Converting an organization member to an outside collaborator</a>\".</p>",
+        "descriptionHTML": "<p>When an organization member is converted to an outside collaborator, they'll only have access to the repositories that their current team membership allows. The user will no longer be a member of the organization. For more information, see \"<a href=\"https://docs.github.com/[email protected]/articles/converting-an-organization-member-to-an-outside-collaborator/\">Converting an organization member to an outside collaborator</a>\".</p>",
         "responses": [
           {
             "httpStatusCode": "202",
@@ -49408,7 +49414,7 @@
           {
             "httpStatusCode": "403",
             "httpStatusMessage": "Forbidden",
-            "description": "<p>Forbidden if user is the last owner of the organization or not a member of the organization</p>"
+            "description": "<p>Forbidden if user is the last owner of the organization or not a member of the organization.</p>"
           },
           {
             "httpStatusCode": "404",