1
0
mirror of synced 2025-12-19 18:10:59 -05:00

Update OpenAPI Description (#57554)

Co-authored-by: Ben Ahmady <32935794+subatoi@users.noreply.github.com>
This commit is contained in:
docs-bot
2025-09-16 01:32:47 -07:00
committed by GitHub
parent 8b6230b14b
commit 260218b24e
9 changed files with 414 additions and 216 deletions

View File

@@ -60,5 +60,5 @@
"2022-11-28" "2022-11-28"
] ]
}, },
"sha": "b31dcc1c69b88654b6fa48764c837c0a6ccd0d28" "sha": "b27d92b4094f9c4c6c60680325830982f04e5449"
} }

View File

@@ -116893,7 +116893,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -120183,7 +120186,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -123579,7 +123585,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -232075,7 +232084,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -237870,7 +237882,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -239006,7 +239021,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -239723,7 +239741,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -240472,7 +240493,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -240585,7 +240609,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -497909,7 +497936,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -498130,7 +498160,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]

View File

@@ -127159,7 +127159,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -130449,7 +130452,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -133845,7 +133851,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -245587,7 +245596,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -251382,7 +251394,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -252518,7 +252533,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -253235,7 +253253,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -253984,7 +254005,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -254097,7 +254121,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -543529,7 +543556,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -543750,7 +543780,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]

View File

@@ -113443,7 +113443,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -116711,7 +116714,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -120085,7 +120091,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -167972,7 +167981,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -173757,7 +173769,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -174879,7 +174894,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -175589,7 +175607,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -176331,7 +176352,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -176444,7 +176468,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -406790,7 +406817,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -407011,7 +407041,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]

View File

@@ -553,13 +553,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Deletes an artifact for a workflow run.\nOAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<p>Deletes an artifact for a workflow run.\nOAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -5461,13 +5461,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Gets the level of access that workflows outside of the repository have to actions and reusable workflows in the repository.\nThis endpoint only applies to internal and private repositories.\nFor more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-a-private-repository\">Allowing access to components in a private repository</a>\" and\n\"<a href=\"https://docs.github.com/enterprise-server@3.15/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository\">Allowing access to components in an internal repository</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Gets the level of access that workflows outside of the repository have to actions and reusable workflows in the repository.\nThis endpoint only applies to internal and private repositories.\nFor more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-a-private-repository\">Allowing access to components in a private repository</a>\" and\n\"<a href=\"https://docs.github.com/enterprise-server@3.15/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository\">Allowing access to components in an internal repository</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -6174,13 +6174,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Gets your public key, which you need to encrypt secrets. You need to\nencrypt a secret before you can create or update secrets.</p>\n<p>The authenticated user must have collaborator access to a repository to create, update, or read secrets.</p>\n<p>OAuth tokens and personal access tokens (classic) need the<code>admin:org</code> scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Gets your public key, which you need to encrypt secrets. You need to\nencrypt a secret before you can create or update secrets.</p>\n<p>The authenticated user must have collaborator access to a repository to create, update, or read secrets.</p>\n<p>OAuth tokens and personal access tokens (classic) need the<code>admin:org</code> scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -9433,13 +9433,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Creates a new self-hosted runner group for an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
] ],
"descriptionHTML": "<p>Creates a new self-hosted runner group for an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -9563,13 +9563,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Gets a specific self-hosted runner group for an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Gets a specific self-hosted runner group for an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -10008,13 +10008,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists the organizations with access to a self-hosted runner group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Lists the organizations with access to a self-hosted runner group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -10083,13 +10083,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Replaces the list of organizations that have access to a self-hosted runner configured in an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<p>Replaces the list of organizations that have access to a self-hosted runner configured in an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -10677,13 +10677,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Removes a self-hosted runner from a group configured in an enterprise. The runner is then returned to the default group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<p>Removes a self-hosted runner from a group configured in an enterprise. The runner is then returned to the default group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -16427,7 +16427,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists all labels for a self-hosted runner configured in an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -16437,7 +16436,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
] ],
"descriptionHTML": "<p>Lists all labels for a self-hosted runner configured in an enterprise.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -20966,13 +20966,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists all self-hosted runners configured in a repository.</p>\n<p>Authenticated users must have admin access to the repository to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Lists all self-hosted runners configured in a repository.</p>\n<p>Authenticated users must have admin access to the repository to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -38534,13 +38534,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Approve or reject custom deployment protection rules provided by a GitHub App for a workflow run. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/actions/deployment/targeting-different-environments/using-environments-for-deployment\">Using environments for deployment</a>.\"</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nGitHub Apps can only review their own custom deployment protection rules. To approve or reject pending deployments that are waiting for review from a specific person or team, see <a href=\"/rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run\"><code>POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments</code></a>.</p>\n</div>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint with a private repository.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<p>Approve or reject custom deployment protection rules provided by a GitHub App for a workflow run. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/actions/deployment/targeting-different-environments/using-environments-for-deployment\">Using environments for deployment</a>.\"</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nGitHub Apps can only review their own custom deployment protection rules. To approve or reject pending deployments that are waiting for review from a specific person or team, see <a href=\"/rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run\"><code>POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments</code></a>.</p>\n</div>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint with a private repository.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -98300,7 +98300,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account.</p>\n<p>You must use a <a href=\"https://docs.github.com/enterprise-server@3.15/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app\">JWT</a> to access this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
@@ -98310,7 +98309,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
] ],
"descriptionHTML": "<p>Suspends a GitHub App on a user, organization, or enterprise account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub Enterprise Server API or webhook events is blocked for that account.</p>\n<p>You must use a <a href=\"https://docs.github.com/enterprise-server@3.15/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app\">JWT</a> to access this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -109851,13 +109851,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Updates the webhook configuration for a GitHub App. For more information about configuring a webhook for your app, see \"<a href=\"/developers/apps/creating-a-github-app\">Creating a GitHub App</a>.\"</p>\n<p>You must use a <a href=\"https://docs.github.com/enterprise-server@3.15/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app\">JWT</a> to access this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Updates the webhook configuration for a GitHub App. For more information about configuring a webhook for your app, see \"<a href=\"/developers/apps/creating-a-github-app\">Creating a GitHub App</a>.\"</p>\n<p>You must use a <a href=\"https://docs.github.com/enterprise-server@3.15/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app\">JWT</a> to access this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -113883,7 +113883,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -117163,7 +117166,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -120549,7 +120555,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -126186,13 +126195,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.15/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.15/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -132056,13 +132065,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.15/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>\n<p>Disables the ability to restrict who can push to this branch.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.15/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>\n<p>Disables the ability to restrict who can push to this branch.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -172135,7 +172144,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -177920,7 +177932,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -179042,7 +179057,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -179752,7 +179770,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -180494,7 +180515,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -180607,7 +180631,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -193345,13 +193372,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists all repositories that have been selected when the <code>visibility</code>\nfor repository access to a secret is set to <code>selected</code>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Lists all repositories that have been selected when the <code>visibility</code>\nfor repository access to a secret is set to <code>selected</code>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -209714,13 +209741,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Parameters that are not provided will be overwritten with the default value or removed if no default exists.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Parameters that are not provided will be overwritten with the default value or removed if no default exists.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -210527,13 +210554,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Note that this API call does not automatically initiate an LDAP sync. Rather, if a <code>201</code> is returned, the sync job is queued successfully, and is performed when the instance is ready.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
] ],
"descriptionHTML": "<p>Note that this API call does not automatically initiate an LDAP sync. Rather, if a <code>201</code> is returned, the sync job is queued successfully, and is performed when the instance is ready.</p>"
} }
], ],
"license": [ "license": [
@@ -214196,13 +214223,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
] ],
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -214888,13 +214915,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -215099,13 +215126,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
] ],
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -225123,7 +225150,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -225133,7 +225159,8 @@
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Response when creating a new impersonation OAuth token</p>" "description": "<p>Response when creating a new impersonation OAuth token</p>"
} }
] ],
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -242858,7 +242885,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Get the content of a gitignore template.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw .gitignore contents.</li>\n</ul>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -242868,7 +242894,8 @@
"httpStatusCode": "304", "httpStatusCode": "304",
"description": "<p>Not modified</p>" "description": "<p>Not modified</p>"
} }
] ],
"descriptionHTML": "<p>Get the content of a gitignore template.</p>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw .gitignore contents.</li>\n</ul>"
} }
] ]
}, },
@@ -246223,7 +246250,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>List issues assigned to the authenticated user across all visible repositories including owned repositories, member\nrepositories, and organization repositories. You can use the <code>filter</code> query parameter to fetch issues that are not\nnecessarily assigned to you.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nGitHub's REST API considers every pull request an issue, but not every issue is a pull request. For this reason, \"Issues\" endpoints may return both issues and pull requests in the response. You can identify pull requests by the <code>pull_request</code> key. Be aware that the <code>id</code> of a pull request returned from \"Issues\" endpoints will be an <em>issue id</em>. To find out the pull request id, use the \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/pulls/pulls#list-pull-requests\">List pull requests</a>\" endpoint.</p>\n</div>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown body. Response will include <code>body</code>. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.text+json</code></strong>: Returns a text only representation of the markdown body. Response will include <code>body_text</code>.</li>\n<li><strong><code>application/vnd.github.html+json</code></strong>: Returns HTML rendered from the body's markdown. Response will include <code>body_html</code>.</li>\n<li><strong><code>application/vnd.github.full+json</code></strong>: Returns raw, text, and HTML representations. Response will include <code>body</code>, <code>body_text</code>, and <code>body_html</code>.</li>\n</ul>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -246241,7 +246267,8 @@
"httpStatusCode": "422", "httpStatusCode": "422",
"description": "<p>Validation failed, or the endpoint has been spammed.</p>" "description": "<p>Validation failed, or the endpoint has been spammed.</p>"
} }
] ],
"descriptionHTML": "<p>List issues assigned to the authenticated user across all visible repositories including owned repositories, member\nrepositories, and organization repositories. You can use the <code>filter</code> query parameter to fetch issues that are not\nnecessarily assigned to you.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nGitHub's REST API considers every pull request an issue, but not every issue is a pull request. For this reason, \"Issues\" endpoints may return both issues and pull requests in the response. You can identify pull requests by the <code>pull_request</code> key. Be aware that the <code>id</code> of a pull request returned from \"Issues\" endpoints will be an <em>issue id</em>. To find out the pull request id, use the \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/pulls/pulls#list-pull-requests\">List pull requests</a>\" endpoint.</p>\n</div>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown body. Response will include <code>body</code>. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.text+json</code></strong>: Returns a text only representation of the markdown body. Response will include <code>body_text</code>.</li>\n<li><strong><code>application/vnd.github.html+json</code></strong>: Returns HTML rendered from the body's markdown. Response will include <code>body_html</code>.</li>\n<li><strong><code>application/vnd.github.full+json</code></strong>: Returns raw, text, and HTML representations. Response will include <code>body</code>, <code>body_text</code>, and <code>body_html</code>.</li>\n</ul>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -269567,13 +269594,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Adds up to 10 assignees to an issue. Users already assigned to an issue are not replaced.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
] ],
"descriptionHTML": "<p>Adds up to 10 assignees to an issue. Users already assigned to an issue are not replaced.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -298472,7 +298499,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists all events for an issue.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -298482,7 +298508,8 @@
"httpStatusCode": "410", "httpStatusCode": "410",
"description": "<p>Gone</p>" "description": "<p>Gone</p>"
} }
] ],
"descriptionHTML": "<p>Lists all events for an issue.</p>"
} }
], ],
"labels": [ "labels": [
@@ -301709,7 +301736,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Gets a milestone using the given milestone number.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -301719,7 +301745,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
] ],
"descriptionHTML": "<p>Gets a milestone using the given milestone number.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -320568,13 +320595,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Get Hypermedia links to resources accessible in GitHub's REST API</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Get Hypermedia links to resources accessible in GitHub's REST API</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -345777,13 +345804,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Closing down notice:</strong> This operation is closing down and will be removed in the future. Use the \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/orgs/custom-roles#list-custom-repository-roles-in-an-organization\">List custom repository roles</a>\" endpoint instead.</p>\n</div>\n<p>List the custom repository roles available in this organization. For more information on custom repository roles, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-repository-roles\">About custom repository roles</a>.\"</p>\n<p>The authenticated user must be administrator of the organization or of a repository of the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> or <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>Response - list of custom role names</p>" "description": "<p>Response - list of custom role names</p>"
} }
] ],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Closing down notice:</strong> This operation is closing down and will be removed in the future. Use the \"<a href=\"https://docs.github.com/enterprise-server@3.15/rest/orgs/custom-roles#list-custom-repository-roles-in-an-organization\">List custom repository roles</a>\" endpoint instead.</p>\n</div>\n<p>List the custom repository roles available in this organization. For more information on custom repository roles, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-repository-roles\">About custom repository roles</a>.\"</p>\n<p>The authenticated user must be administrator of the organization or of a repository of the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> or <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -350258,7 +350285,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>If the authenticated user is an active or pending member of the organization, this endpoint will return the user's membership. If the authenticated user is not affiliated with the organization, a <code>404</code> is returned. This endpoint will return a <code>403</code> if the request is made by a GitHub App that is blocked by the organization.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -350272,7 +350298,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
] ],
"descriptionHTML": "<p>If the authenticated user is an active or pending member of the organization, this endpoint will return the user's membership. If the authenticated user is not affiliated with the organization, a <code>404</code> is returned. This endpoint will return a <code>403</code> if the request is made by a GitHub App that is blocked by the organization.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -356419,7 +356446,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Updates the access organization members have to organization resources via fine-grained personal access tokens. Limited to revoking a token's existing access.</p>\n<p>Only GitHub Apps can use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "202", "httpStatusCode": "202",
@@ -356441,7 +356467,8 @@
"httpStatusCode": "500", "httpStatusCode": "500",
"description": "<p>Internal Error</p>" "description": "<p>Internal Error</p>"
} }
] ],
"descriptionHTML": "<p>Updates the access organization members have to organization resources via fine-grained personal access tokens. Limited to revoking a token's existing access.</p>\n<p>Only GitHub Apps can use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -365302,13 +365329,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Adds a team as a security manager for an organization. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security for an organization</a> for an organization.\"</p>\n<p>The authenticated user must be an administrator for the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>write:org</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<p>Adds a team as a security manager for an organization. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security for an organization</a> for an organization.\"</p>\n<p>The authenticated user must be an administrator for the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>write:org</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -374402,7 +374429,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists packages owned by the authenticated user within the user's namespace.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>read:packages</code> scope to use this endpoint. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages\">About permissions for GitHub Packages</a>.\"</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -374412,7 +374438,8 @@
"httpStatusCode": "400", "httpStatusCode": "400",
"description": "<p>The value of <code>per_page</code> multiplied by <code>page</code> cannot be greater than 10000.</p>" "description": "<p>The value of <code>per_page</code> multiplied by <code>page</code> cannot be greater than 10000.</p>"
} }
] ],
"descriptionHTML": "<p>Lists packages owned by the authenticated user within the user's namespace.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>read:packages</code> scope to use this endpoint. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages\">About permissions for GitHub Packages</a>.\"</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -410592,7 +410619,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -410813,7 +410843,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -410995,7 +411028,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Checks if a pull request has been merged into the base branch. The HTTP status of the response indicates whether or not the pull request has been merged; the response body is empty.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
@@ -411005,7 +411037,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Not Found if pull request has not been merged</p>" "description": "<p>Not Found if pull request has not been merged</p>"
} }
] ],
"descriptionHTML": "<p>Checks if a pull request has been merged into the base branch. The HTTP status of the response indicates whether or not the pull request has been merged; the response body is empty.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -435584,7 +435617,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>List the reactions to a <a href=\"https://docs.github.com/enterprise-server@3.15/rest/pulls/comments#get-a-review-comment-for-a-pull-request\">pull request review comment</a>.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -435594,7 +435626,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
] ],
"descriptionHTML": "<p>List the reactions to a <a href=\"https://docs.github.com/enterprise-server@3.15/rest/pulls/comments#get-a-review-comment-for-a-pull-request\">pull request review comment</a>.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -437373,13 +437406,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nYou can also specify a repository by <code>repository_id</code> using the route <code>DELETE delete /repositories/:repository_id/releases/:release_id/reactions/:reaction_id</code>.</p>\n</div>\n<p>Delete a reaction to a <a href=\"https://docs.github.com/enterprise-server@3.15/rest/releases/releases#get-a-release\">release</a>.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
] ],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nYou can also specify a repository by <code>repository_id</code> using the route <code>DELETE delete /repositories/:repository_id/releases/:release_id/reactions/:reaction_id</code>.</p>\n</div>\n<p>Delete a reaction to a <a href=\"https://docs.github.com/enterprise-server@3.15/rest/releases/releases#get-a-release\">release</a>.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -462338,13 +462371,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -468917,13 +468950,13 @@
} }
} }
], ],
"descriptionHTML": "<p>Creates a new repository using a repository template. Use the <code>template_owner</code> and <code>template_repo</code> route parameters to specify the repository to use as the template. If the repository is not public, the authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the <a href=\"https://docs.github.com/enterprise-server@3.15/rest/repos/repos#get-a-repository\">Get a repository</a> endpoint and check that the <code>is_template</code> key is <code>true</code>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>public_repo</code> or <code>repo</code> scope to create a public repository, and <code>repo</code> scope to create a private repository.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
], ],
"descriptionHTML": "<p>Creates a new repository using a repository template. Use the <code>template_owner</code> and <code>template_repo</code> route parameters to specify the repository to use as the template. If the repository is not public, the authenticated user must own or be a member of an organization that owns the repository. To check if a repository is available to use as a template, get the repository's information using the <a href=\"https://docs.github.com/enterprise-server@3.15/rest/repos/repos#get-a-repository\">Get a repository</a> endpoint and check that the <code>is_template</code> key is <code>true</code>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>public_repo</code> or <code>repo</code> scope to create a public repository, and <code>repo</code> scope to create a private repository.</p>",
"previews": [ "previews": [
"<p>Creating and using repository templates is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom <a href=\"https://docs.github.com/enterprise-server@3.15/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">media type</a> in the <code>Accept</code> header:</p>\n<pre><code class=\"hljs language-shell\">application/vnd.github.baptiste-preview+json\n</code></pre>" "<p>Creating and using repository templates is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom <a href=\"https://docs.github.com/enterprise-server@3.15/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">media type</a> in the <code>Accept</code> header:</p>\n<pre><code class=\"hljs language-shell\">application/vnd.github.baptiste-preview+json\n</code></pre>"
] ]
@@ -487755,7 +487788,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists suites of rule evaluations at the repository level.\nFor more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/managing-rulesets-for-a-repository#viewing-insights-for-rulesets\">Managing rulesets for a repository</a>.\"</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -487769,7 +487801,8 @@
"httpStatusCode": "500", "httpStatusCode": "500",
"description": "<p>Internal Error</p>" "description": "<p>Internal Error</p>"
} }
] ],
"descriptionHTML": "<p>Lists suites of rule evaluations at the repository level.\nFor more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/managing-rulesets-for-a-repository#viewing-insights-for-rulesets\">Managing rulesets for a repository</a>.\"</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -497679,7 +497712,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Updates a webhook configured in a repository. If you previously had a <code>secret</code> set, you must provide the same <code>secret</code> or set a new <code>secret</code> or the secret will be removed. If you are only updating individual webhook <code>config</code> properties, use \"<a href=\"/rest/webhooks/repo-config#update-a-webhook-configuration-for-a-repository\">Update a webhook configuration for a repository</a>.\"</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -497693,7 +497725,8 @@
"httpStatusCode": "422", "httpStatusCode": "422",
"description": "<p>Validation failed, or the endpoint has been spammed.</p>" "description": "<p>Validation failed, or the endpoint has been spammed.</p>"
} }
] ],
"descriptionHTML": "<p>Updates a webhook configured in a repository. If you previously had a <code>secret</code> set, you must provide the same <code>secret</code> or set a new <code>secret</code> or the secret will be removed. If you are only updating individual webhook <code>config</code> properties, use \"<a href=\"/rest/webhooks/repo-config#update-a-webhook-configuration-for-a-repository\">Update a webhook configuration for a repository</a>.\"</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -523924,7 +523957,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Closing down notice:</strong> Projects (classic) is being deprecated in favor of the new Projects experience.\nSee the <a href=\"https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/\">changelog</a> for more information.</p>\n</div>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
@@ -523938,7 +523970,8 @@
"httpStatusCode": "422", "httpStatusCode": "422",
"description": "<p>Validation failed, or the endpoint has been spammed.</p>" "description": "<p>Validation failed, or the endpoint has been spammed.</p>"
} }
] ],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Closing down notice:</strong> Projects (classic) is being deprecated in favor of the new Projects experience.\nSee the <a href=\"https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/\">changelog</a> for more information.</p>\n</div>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -533717,13 +533750,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Endpoint closing down notice:</strong> This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new <a href=\"https://docs.github.com/enterprise-server@3.15/rest/teams/discussions#list-discussions\"><code>List discussions</code></a> endpoint.</p>\n</div>\n<p>List all discussions on a team's page.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>read:discussion</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Endpoint closing down notice:</strong> This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new <a href=\"https://docs.github.com/enterprise-server@3.15/rest/teams/discussions#list-discussions\"><code>List discussions</code></a> endpoint.</p>\n</div>\n<p>List all discussions on a team's page.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>read:discussion</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -535994,13 +536027,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Creates a connection between a team and an external group. Only one external group can be linked to a team.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
] ],
"descriptionHTML": "<p>Creates a connection between a team and an external group. Only one external group can be linked to a team.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.15/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -536970,7 +537003,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Endpoint closing down notice:</strong> This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new <a href=\"https://docs.github.com/enterprise-server@3.15/rest/teams/members#list-team-members\"><code>List team members</code></a> endpoint.</p>\n</div>\n<p>Team members will include the members of child teams.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -536980,7 +537012,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
] ],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Endpoint closing down notice:</strong> This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new <a href=\"https://docs.github.com/enterprise-server@3.15/rest/teams/members#list-team-members\"><code>List team members</code></a> endpoint.</p>\n</div>\n<p>Team members will include the members of child teams.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -537038,7 +537071,6 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>The \"Get team member\" endpoint (described below) is closing down.</p>\n<p>We recommend using the <a href=\"https://docs.github.com/enterprise-server@3.15/rest/teams/members#get-team-membership-for-a-user\">Get team membership for a user</a> endpoint instead. It allows you to get both active and pending memberships.</p>\n<p>To list members in a team, the team must be visible to the authenticated user.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
@@ -537048,7 +537080,8 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>if user is not a member</p>" "description": "<p>if user is not a member</p>"
} }
] ],
"descriptionHTML": "<p>The \"Get team member\" endpoint (described below) is closing down.</p>\n<p>We recommend using the <a href=\"https://docs.github.com/enterprise-server@3.15/rest/teams/members#get-team-membership-for-a-user\">Get team membership for a user</a> endpoint instead. It allows you to get both active and pending memberships.</p>\n<p>To list members in a team, the team must be visible to the authenticated user.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",

View File

@@ -113981,7 +113981,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -117261,7 +117264,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -120647,7 +120653,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -175785,7 +175794,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -181570,7 +181582,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -182692,7 +182707,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -183402,7 +183420,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -184144,7 +184165,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -184257,7 +184281,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -416585,7 +416612,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -416806,7 +416836,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]

View File

@@ -1846,13 +1846,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists the GitHub Actions caches for a repository.</p>\n<p>OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Lists the GitHub Actions caches for a repository.</p>\n<p>OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -5032,13 +5032,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Sets the actions that are allowed in an organization. To use this endpoint, the organization permission policy for <code>allowed_actions</code> must be configured to <code>selected</code>. For more information, see \"<a href=\"#set-github-actions-permissions-for-an-organization\">Set GitHub Actions permissions for an organization</a>.\"</p>\n<p>If the organization belongs to an enterprise that has <code>selected</code> actions set at the enterprise level, then you cannot override any of the enterprise's allowed actions settings.</p>\n<p>To use the <code>patterns_allowed</code> setting for private repositories, the organization must belong to an enterprise. If the organization does not belong to an enterprise, then the <code>patterns_allowed</code> setting only applies to public repositories in the organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Sets the actions that are allowed in an organization. To use this endpoint, the organization permission policy for <code>allowed_actions</code> must be configured to <code>selected</code>. For more information, see \"<a href=\"#set-github-actions-permissions-for-an-organization\">Set GitHub Actions permissions for an organization</a>.\"</p>\n<p>If the organization belongs to an enterprise that has <code>selected</code> actions set at the enterprise level, then you cannot override any of the enterprise's allowed actions settings.</p>\n<p>To use the <code>patterns_allowed</code> setting for private repositories, the organization must belong to an enterprise. If the organization does not belong to an enterprise, then the <code>patterns_allowed</code> setting only applies to public repositories in the organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -8451,13 +8451,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Deletes a secret in a repository using the secret name.</p>\n<p>Authenticated users must have collaborator access to a repository to create, update, or read secrets.</p>\n<p>OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Deletes a secret in a repository using the secret name.</p>\n<p>Authenticated users must have collaborator access to a repository to create, update, or read secrets.</p>\n<p>OAuth tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -10020,13 +10020,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists the organizations with access to a self-hosted runner group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Lists the organizations with access to a self-hosted runner group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -10235,13 +10235,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Removes an organization from the list of selected organizations that can access a self-hosted runner group. The runner group must have <code>visibility</code> set to <code>selected</code>. For more information, see \"<a href=\"#create-a-self-hosted-runner-group-for-an-enterprise\">Create a self-hosted runner group for an enterprise</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Removes an organization from the list of selected organizations that can access a self-hosted runner group. The runner group must have <code>visibility</code> set to <code>selected</code>. For more information, see \"<a href=\"#create-a-self-hosted-runner-group-for-an-enterprise\">Create a self-hosted runner group for an enterprise</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -10689,13 +10689,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Removes a self-hosted runner from a group configured in an enterprise. The runner is then returned to the default group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Removes a self-hosted runner from a group configured in an enterprise. The runner is then returned to the default group.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>manage_runners:enterprise</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -12747,13 +12747,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Replaces the list of repositories that have access to a self-hosted runner group configured in an organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Replaces the list of repositories that have access to a self-hosted runner group configured in an organization.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -12897,13 +12897,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Removes a repository from the list of selected repositories that can access a self-hosted runner group. The runner group must have <code>visibility</code> set to <code>selected</code>. For more information, see \"<a href=\"#create-a-self-hosted-runner-group-for-an-organization\">Create a self-hosted runner group for an organization</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Removes a repository from the list of selected repositories that can access a self-hosted runner group. The runner group must have <code>visibility</code> set to <code>selected</code>. For more information, see \"<a href=\"#create-a-self-hosted-runner-group-for-an-organization\">Create a self-hosted runner group for an organization</a>.\"</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -27606,13 +27606,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Updates an environment variable that you can reference in a GitHub Actions workflow.</p>\n<p>Authenticated users must have collaborator access to a repository to create, update, or read variables.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>Updates an environment variable that you can reference in a GitHub Actions workflow.</p>\n<p>Authenticated users must have collaborator access to a repository to create, update, or read variables.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -40375,13 +40375,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Approve or reject pending deployments that are waiting on approval by a required reviewer.</p>\n<p>Required reviewers with read access to the repository contents and deployments can use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Approve or reject pending deployments that are waiting on approval by a required reviewer.</p>\n<p>Required reviewers with read access to the repository contents and deployments can use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -82407,13 +82407,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Marks a thread as \"done.\" Marking a thread as \"done\" is equivalent to marking a notification in your notification inbox on GitHub Enterprise Server as done: <a href=\"https://github.com/notifications\">https://github.com/notifications</a>.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No content</p>" "description": "<p>No content</p>"
} }
], ]
"descriptionHTML": "<p>Marks a thread as \"done.\" Marking a thread as \"done\" is equivalent to marking a notification in your notification inbox on GitHub Enterprise Server as done: <a href=\"https://github.com/notifications\">https://github.com/notifications</a>.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -90123,13 +90123,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>This endpoint should only be used to stop watching a repository. To control whether or not you wish to receive notifications from a repository, <a href=\"https://docs.github.com/enterprise-server@3.17/rest/activity/watching#set-a-repository-subscription\">set the repository's subscription manually</a>.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": "<p>This endpoint should only be used to stop watching a repository. To control whether or not you wish to receive notifications from a repository, <a href=\"https://docs.github.com/enterprise-server@3.17/rest/activity/watching#set-a-repository-subscription\">set the repository's subscription manually</a>.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -114196,7 +114196,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -117486,7 +117489,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -120882,7 +120888,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -126623,13 +126632,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.17/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>\n<p>Adding admin enforcement requires admin or owner permissions to the repository and branch protection to be enabled.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.17/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>\n<p>Adding admin enforcement requires admin or owner permissions to the repository and branch protection to be enabled.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -176496,7 +176505,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -182291,7 +182303,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -183427,7 +183442,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -184144,7 +184162,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -184893,7 +184914,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -185006,7 +185030,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -205280,13 +205307,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nTo get information about name patterns that branches must match in order to deploy to this environment, see \"<a href=\"/rest/deployments/branch-policies#get-a-deployment-branch-policy\">Get a deployment branch policy</a>.\"</p>\n</div>\n<p>Anyone with read access to the repository can use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint with a private repository.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nTo get information about name patterns that branches must match in order to deploy to this environment, see \"<a href=\"/rest/deployments/branch-policies#get-a-deployment-branch-policy\">Get a deployment branch policy</a>.\"</p>\n</div>\n<p>Anyone with read access to the repository can use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint with a private repository.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -206575,13 +206602,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Enable a custom deployment protection rule for an environment.</p>\n<p>The authenticated user must have admin or owner permissions to the repository to use this endpoint.</p>\n<p>For more information about the app that is providing this custom deployment rule, see the <a href=\"https://docs.github.com/enterprise-server@3.17/rest/apps/apps#get-an-app\">documentation for the <code>GET /apps/{app_slug}</code> endpoint</a>, as well as the <a href=\"https://docs.github.com/enterprise-server@3.17/actions/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules\">guide to creating custom deployment protection rules</a>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>The enabled custom deployment protection rule</p>" "description": "<p>The enabled custom deployment protection rule</p>"
} }
], ]
"descriptionHTML": "<p>Enable a custom deployment protection rule for an environment.</p>\n<p>The authenticated user must have admin or owner permissions to the repository to use this endpoint.</p>\n<p>For more information about the app that is providing this custom deployment rule, see the <a href=\"https://docs.github.com/enterprise-server@3.17/rest/apps/apps#get-an-app\">documentation for the <code>GET /apps/{app_slug}</code> endpoint</a>, as well as the <a href=\"https://docs.github.com/enterprise-server@3.17/actions/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules\">guide to creating custom deployment protection rules</a>.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -215424,13 +215451,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
], ]
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -216012,13 +216039,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Note that this API call does not automatically initiate an LDAP sync. Rather, if a <code>201</code> is returned, the sync job is queued successfully, and is performed when the instance is ready.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Created</p>" "description": "<p>Created</p>"
} }
], ]
"descriptionHTML": "<p>Note that this API call does not automatically initiate an LDAP sync. Rather, if a <code>201</code> is returned, the sync job is queued successfully, and is performed when the instance is ready.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -231186,6 +231213,7 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -231195,8 +231223,7 @@
"httpStatusCode": "201", "httpStatusCode": "201",
"description": "<p>Response when creating a new impersonation OAuth token</p>" "description": "<p>Response when creating a new impersonation OAuth token</p>"
} }
], ]
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -272192,6 +272219,7 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>List issues across owned and member repositories assigned to the authenticated user.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nGitHub's REST API considers every pull request an issue, but not every issue is a pull request. For this reason, \"Issues\" endpoints may return both issues and pull requests in the response. You can identify pull requests by the <code>pull_request</code> key. Be aware that the <code>id</code> of a pull request returned from \"Issues\" endpoints will be an <em>issue id</em>. To find out the pull request id, use the \"<a href=\"https://docs.github.com/enterprise-server@3.17/rest/pulls/pulls#list-pull-requests\">List pull requests</a>\" endpoint.</p>\n</div>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown body. Response will include <code>body</code>. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.text+json</code></strong>: Returns a text only representation of the markdown body. Response will include <code>body_text</code>.</li>\n<li><strong><code>application/vnd.github.html+json</code></strong>: Returns HTML rendered from the body's markdown. Response will include <code>body_html</code>.</li>\n<li><strong><code>application/vnd.github.full+json</code></strong>: Returns raw, text, and HTML representations. Response will include <code>body</code>, <code>body_text</code>, and <code>body_html</code>.</li>\n</ul>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -272205,8 +272233,7 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
], ]
"descriptionHTML": "<p>List issues across owned and member repositories assigned to the authenticated user.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nGitHub's REST API considers every pull request an issue, but not every issue is a pull request. For this reason, \"Issues\" endpoints may return both issues and pull requests in the response. You can identify pull requests by the <code>pull_request</code> key. Be aware that the <code>id</code> of a pull request returned from \"Issues\" endpoints will be an <em>issue id</em>. To find out the pull request id, use the \"<a href=\"https://docs.github.com/enterprise-server@3.17/rest/pulls/pulls#list-pull-requests\">List pull requests</a>\" endpoint.</p>\n</div>\n<p>This endpoint supports the following custom media types. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types\">Media types</a>.\"</p>\n<ul>\n<li><strong><code>application/vnd.github.raw+json</code></strong>: Returns the raw markdown body. Response will include <code>body</code>. This is the default if you do not pass any specific media type.</li>\n<li><strong><code>application/vnd.github.text+json</code></strong>: Returns a text only representation of the markdown body. Response will include <code>body_text</code>.</li>\n<li><strong><code>application/vnd.github.html+json</code></strong>: Returns HTML rendered from the body's markdown. Response will include <code>body_html</code>.</li>\n<li><strong><code>application/vnd.github.full+json</code></strong>: Returns raw, text, and HTML representations. Response will include <code>body</code>, <code>body_text</code>, and <code>body_html</code>.</li>\n</ul>"
} }
], ],
"assignees": [ "assignees": [
@@ -305698,6 +305725,7 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Lists all labels for a repository.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
@@ -305707,8 +305735,7 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
], ]
"descriptionHTML": "<p>Lists all labels for a repository.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -326986,13 +327013,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Get the octocat as ASCII art</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Get the octocat as ASCII art</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -332564,6 +332591,7 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Unlocks a repository that was locked for migration. You should unlock each migrated repository and <a href=\"https://docs.github.com/enterprise-server@3.17/rest/repos/repos#delete-a-repository\">delete them</a> when the migration is complete and you no longer need the source data.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
@@ -332573,8 +332601,7 @@
"httpStatusCode": "404", "httpStatusCode": "404",
"description": "<p>Resource not found</p>" "description": "<p>Resource not found</p>"
} }
], ]
"descriptionHTML": "<p>Unlocks a repository that was locked for migration. You should unlock each migrated repository and <a href=\"https://docs.github.com/enterprise-server@3.17/rest/repos/repos#delete-a-repository\">delete them</a> when the migration is complete and you no longer need the source data.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -352515,13 +352542,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Closing down notice:</strong> This operation is closing down and will be removed in the future. Use the \"<a href=\"https://docs.github.com/enterprise-server@3.17/rest/orgs/custom-roles#list-custom-repository-roles-in-an-organization\">List custom repository roles</a>\" endpoint instead.</p>\n</div>\n<p>List the custom repository roles available in this organization. For more information on custom repository roles, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-repository-roles\">About custom repository roles</a>.\"</p>\n<p>The authenticated user must be administrator of the organization or of a repository of the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> or <code>repo</code> scope to use this endpoint.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>Response - list of custom role names</p>" "description": "<p>Response - list of custom role names</p>"
} }
], ]
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Closing down notice:</strong> This operation is closing down and will be removed in the future. Use the \"<a href=\"https://docs.github.com/enterprise-server@3.17/rest/orgs/custom-roles#list-custom-repository-roles-in-an-organization\">List custom repository roles</a>\" endpoint instead.</p>\n</div>\n<p>List the custom repository roles available in this organization. For more information on custom repository roles, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-repository-roles\">About custom repository roles</a>.\"</p>\n<p>The authenticated user must be administrator of the organization or of a repository of the organization to use this endpoint.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>admin:org</code> or <code>repo</code> scope to use this endpoint.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -387962,13 +387989,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Gets a specific package metadata for a public package owned by a user.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>read:packages</code> scope to use this endpoint. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages\">About permissions for GitHub Packages</a>.\"</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Gets a specific package metadata for a public package owned by a user.</p>\n<p>OAuth app tokens and personal access tokens (classic) need the <code>read:packages</code> scope to use this endpoint. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages\">About permissions for GitHub Packages</a>.\"</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -417217,7 +417244,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -417438,7 +417468,10 @@
"type": "object", "type": "object",
"properties": { "properties": {
"sha": { "sha": {
"type": "string", "type": [
"string",
"null"
],
"examples": [ "examples": [
"bbcd538c8e72b8c175046e27cc8f907076331401" "bbcd538c8e72b8c175046e27cc8f907076331401"
] ]
@@ -451179,13 +451212,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
"description": "<p>No Content</p>" "description": "<p>No Content</p>"
} }
], ]
"descriptionHTML": ""
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -451569,13 +451602,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": ""
}, },
{ {
"serverUrl": "https://HOSTNAME/api/uploads", "serverUrl": "https://HOSTNAME/api/uploads",
@@ -488966,13 +488999,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Gets a redirect URL to download a zip archive for a repository. If you omit <code>:ref</code>, the repositorys default branch (usually\n<code>main</code>) will be used. Please make sure your HTTP framework is configured to follow redirects or you will need to use\nthe <code>Location</code> header to make a second <code>GET</code> request.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nFor private repositories, these links are temporary and expire after five minutes. If the repository is empty, you will receive a 404 when you follow the redirect.</p>\n</div>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "302", "httpStatusCode": "302",
"description": "<p>Found</p>" "description": "<p>Found</p>"
} }
], ]
"descriptionHTML": "<p>Gets a redirect URL to download a zip archive for a repository. If you omit <code>:ref</code>, the repositorys default branch (usually\n<code>main</code>) will be used. Please make sure your HTTP framework is configured to follow redirects or you will need to use\nthe <code>Location</code> header to make a second <code>GET</code> request.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nFor private repositories, these links are temporary and expire after five minutes. If the repository is empty, you will receive a 404 when you follow the redirect.</p>\n</div>"
} }
], ],
"custom-properties": [ "custom-properties": [
@@ -547055,13 +547088,13 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<p>Displays information about the specific group's usage. Provides a list of the group's external members as well as a list of teams that this group is connected to.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "200", "httpStatusCode": "200",
"description": "<p>OK</p>" "description": "<p>OK</p>"
} }
], ]
"descriptionHTML": "<p>Displays information about the specific group's usage. Provides a list of the group's external members as well as a list of teams that this group is connected to.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>"
}, },
{ {
"serverUrl": "http(s)://HOSTNAME/api/v3", "serverUrl": "http(s)://HOSTNAME/api/v3",
@@ -549070,6 +549103,7 @@
} }
], ],
"previews": [], "previews": [],
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Endpoint closing down notice:</strong> This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new <a href=\"https://docs.github.com/enterprise-server@3.17/rest/teams/members#remove-team-membership-for-a-user\">Remove team membership for a user</a> endpoint.</p>\n</div>\n<p>Team synchronization is available for organizations using GitHub Enterprise Cloud. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.17/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>\n<p>To remove a membership between a user and a team, the authenticated user must have 'admin' permissions to the team or be an owner of the organization that the team is associated with. Removing team membership does not delete the user, it just removes their membership from the team.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nWhen you have team synchronization set up for a team with your organization's identity provider (IdP), you will see an error if you attempt to use the API for making changes to the team's membership. If you have access to manage group membership in your IdP, you can manage GitHub Enterprise Server team membership through your identity provider, which automatically adds and removes team members in an organization. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/articles/synchronizing-teams-between-your-identity-provider-and-github/\">Synchronizing teams between your identity provider and GitHub Enterprise Server</a>.\"</p>\n</div>",
"statusCodes": [ "statusCodes": [
{ {
"httpStatusCode": "204", "httpStatusCode": "204",
@@ -549079,8 +549113,7 @@
"httpStatusCode": "403", "httpStatusCode": "403",
"description": "<p>if team synchronization is set up</p>" "description": "<p>if team synchronization is set up</p>"
} }
], ]
"descriptionHTML": "<div class=\"ghd-alert ghd-alert-attention\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"></path></svg>Warning</p>\n<p>\n<strong>Endpoint closing down notice:</strong> This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new <a href=\"https://docs.github.com/enterprise-server@3.17/rest/teams/members#remove-team-membership-for-a-user\">Remove team membership for a user</a> endpoint.</p>\n</div>\n<p>Team synchronization is available for organizations using GitHub Enterprise Cloud. For more information, see <a href=\"https://docs.github.com/enterprise-server@3.17/github/getting-started-with-github/githubs-products\">GitHub's products</a> in the GitHub Help documentation.</p>\n<p>To remove a membership between a user and a team, the authenticated user must have 'admin' permissions to the team or be an owner of the organization that the team is associated with. Removing team membership does not delete the user, it just removes their membership from the team.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nWhen you have team synchronization set up for a team with your organization's identity provider (IdP), you will see an error if you attempt to use the API for making changes to the team's membership. If you have access to manage group membership in your IdP, you can manage GitHub Enterprise Server team membership through your identity provider, which automatically adds and removes team members in an organization. For more information, see \"<a href=\"https://docs.github.com/enterprise-server@3.17/articles/synchronizing-teams-between-your-identity-provider-and-github/\">Synchronizing teams between your identity provider and GitHub Enterprise Server</a>.\"</p>\n</div>"
} }
] ]
}, },

View File

@@ -44,5 +44,5 @@
] ]
} }
}, },
"sha": "b31dcc1c69b88654b6fa48764c837c0a6ccd0d28" "sha": "b27d92b4094f9c4c6c60680325830982f04e5449"
} }

View File

@@ -1,3 +1,3 @@
{ {
"sha": "b31dcc1c69b88654b6fa48764c837c0a6ccd0d28" "sha": "b27d92b4094f9c4c6c60680325830982f04e5449"
} }