summaryrefslogtreecommitdiffstats
path: root/descriptions/api.github.com/dereferenced/api.github.com.deref.json
diff options
context:
space:
mode:
authorgithub-openapi-bot <security+github-openapi-bot@github.com>2020-10-09 11:26:16 -0700
committergithub-openapi-bot <security+github-openapi-bot@github.com>2020-10-09 11:26:16 -0700
commit6e29a0be9e57f86aa2f79b2cb909fcb0db937c4c (patch)
tree3539520ca908036055b3490359e044fbbc9de2d0 /descriptions/api.github.com/dereferenced/api.github.com.deref.json
parente2d87875b13dc8364b59d8ecab7d9a68768a5f2a (diff)
downloadrest-api-description-6e29a0be9e57f86aa2f79b2cb909fcb0db937c4c.tar.gz
rest-api-description-6e29a0be9e57f86aa2f79b2cb909fcb0db937c4c.zip
feat: Update the OpenAPI description to the latest version
Diffstat (limited to 'descriptions/api.github.com/dereferenced/api.github.com.deref.json')
-rw-r--r--descriptions/api.github.com/dereferenced/api.github.com.deref.json2646
1 files changed, 2611 insertions, 35 deletions
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
index d221c031b..6acc739b1 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
@@ -1,7 +1,7 @@
{
"openapi": "3.0.3",
"info": {
- "version": "1.0.1",
+ "version": "1.1.0",
"title": "GitHub v3 REST API",
"description": "GitHub's v3 REST API.",
"license": {
@@ -12132,6 +12132,639 @@
}
}
},
+ "/enterprises/{enterprise}/actions/permissions": {
+ "get": {
+ "summary": "Get GitHub Actions permissions for an enterprise",
+ "description": "Gets the GitHub Actions permissions policy for organizations and allowed actions in an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/get-github-actions-permissions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#get-github-actions-permissions-for-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "enabled_organizations": {
+ "type": "string",
+ "description": "The policy that controls the organizations in the enterprise that are allowed to run GitHub Actions. Can be one of: `all`, `none`, or `selected`.",
+ "enum": [
+ "all",
+ "none",
+ "selected"
+ ]
+ },
+ "selected_organizations_url": {
+ "type": "string",
+ "description": "The API URL to use to get or set the selected organizations that are allowed to run GitHub Actions, when `enabled_organizations` is set to `selected`."
+ },
+ "allowed_actions": {
+ "type": "string",
+ "description": "The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.",
+ "enum": [
+ "all",
+ "local_only",
+ "selected"
+ ]
+ },
+ "selected_actions_url": {
+ "type": "string",
+ "description": "The API URL to use to get or set the actions that are allowed to run, when `allowed_actions` is set to `selected`."
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "enabled_organizations": "all",
+ "allowed_actions": "selected",
+ "selected_actions_url": "https://api.github.com/enterprises/2/actions/permissions/selected-actions"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ },
+ "put": {
+ "summary": "Set GitHub Actions permissions for an enterprise",
+ "description": "Sets the GitHub Actions permissions policy for organizations and allowed actions in an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/set-github-actions-permissions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#set-github-actions-permissions-for-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "enabled_organizations": {
+ "type": "string",
+ "description": "The policy that controls the organizations in the enterprise that are allowed to run GitHub Actions. Can be one of: `all`, `none`, or `selected`.",
+ "enum": [
+ "all",
+ "none",
+ "selected"
+ ]
+ },
+ "allowed_actions": {
+ "type": "string",
+ "description": "The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.",
+ "enum": [
+ "all",
+ "local_only",
+ "selected"
+ ]
+ }
+ },
+ "required": [
+ "enabled_organizations"
+ ]
+ },
+ "example": {
+ "enabled_organizations": "all",
+ "allowed_actions": "selected"
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ }
+ },
+ "/enterprises/{enterprise}/actions/permissions/organizations": {
+ "get": {
+ "summary": "List selected organizations enabled for GitHub Actions in an enterprise",
+ "description": "Lists the organizations that are selected to have GitHub Actions enabled in an enterprise. To use this endpoint, the enterprise permission policy for `enabled_organizations` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/list-selected-organizations-enabled-github-actions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#list-selected-organizations-enabled-for-github-actions-in-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100)",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "total_count": {
+ "type": "number"
+ },
+ "organizations": {
+ "type": "array",
+ "items": {
+ "title": "Organization Simple",
+ "description": "Organization Simple",
+ "type": "object",
+ "properties": {
+ "login": {
+ "type": "string",
+ "example": "github"
+ },
+ "id": {
+ "type": "integer",
+ "example": 1
+ },
+ "node_id": {
+ "type": "string",
+ "example": "MDEyOk9yZ2FuaXphdGlvbjE="
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/orgs/github"
+ },
+ "repos_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/orgs/github/repos"
+ },
+ "events_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/orgs/github/events"
+ },
+ "hooks_url": {
+ "type": "string",
+ "example": "https://api.github.com/orgs/github/hooks"
+ },
+ "issues_url": {
+ "type": "string",
+ "example": "https://api.github.com/orgs/github/issues"
+ },
+ "members_url": {
+ "type": "string",
+ "example": "https://api.github.com/orgs/github/members{/member}"
+ },
+ "public_members_url": {
+ "type": "string",
+ "example": "https://api.github.com/orgs/github/public_members{/member}"
+ },
+ "avatar_url": {
+ "type": "string",
+ "example": "https://github.com/images/error/octocat_happy.gif"
+ },
+ "description": {
+ "type": "string",
+ "example": "A great organization",
+ "nullable": true
+ }
+ },
+ "required": [
+ "login",
+ "url",
+ "id",
+ "node_id",
+ "repos_url",
+ "events_url",
+ "hooks_url",
+ "issues_url",
+ "members_url",
+ "public_members_url",
+ "avatar_url",
+ "description"
+ ]
+ }
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "total_count": 1,
+ "organizations": [
+ {
+ "login": "octocat",
+ "id": 161335,
+ "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
+ "url": "https://api.github.com/orgs/octo-org",
+ "repos_url": "https://api.github.com/orgs/octo-org/repos",
+ "events_url": "https://api.github.com/orgs/octo-org/events",
+ "hooks_url": "https://api.github.com/orgs/octo-org/hooks",
+ "issues_url": "https://api.github.com/orgs/octo-org/issues",
+ "members_url": "https://api.github.com/orgs/octo-org/members{/member}",
+ "public_members_url": "https://api.github.com/orgs/octo-org/public_members{/member}",
+ "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+ "description": "A great organization"
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ },
+ "put": {
+ "summary": "Set selected organizations enabled for GitHub Actions in an enterprise",
+ "description": "Replaces the list of selected organizations that are enabled for GitHub Actions in an enterprise. To use this endpoint, the enterprise permission policy for `enabled_organizations` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/set-selected-organizations-enabled-github-actions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#set-selected-organizations-enabled-for-github-actions-in-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "selected_organization_ids": {
+ "description": "List of organization IDs to enable for GitHub Actions.",
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "description": "Unique identifier of the organization."
+ }
+ }
+ },
+ "required": [
+ "selected_organization_ids"
+ ]
+ },
+ "example": {
+ "selected_organization_ids": [
+ 32,
+ 91
+ ]
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ }
+ },
+ "/enterprises/{enterprise}/actions/permissions/organizations/{org_id}": {
+ "put": {
+ "summary": "Enable a selected organization for GitHub Actions in an enterprise",
+ "description": "Adds an organization to the list of selected organizations that are enabled for GitHub Actions in an enterprise. To use this endpoint, the enterprise permission policy for `enabled_organizations` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/enable-selected-organization-github-actions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#enable-a-selected-organization-for-github-actions-in-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "org_id",
+ "description": "Unique identifier of an organization.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ },
+ "delete": {
+ "summary": "Disable a selected organization for GitHub Actions in an enterprise",
+ "description": "Removes an organization from the list of selected organizations that are enabled for GitHub Actions in an enterprise. To use this endpoint, the enterprise permission policy for `enabled_organizations` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/disable-selected-organization-github-actions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#disable-a-selected-organization-for-github-actions-in-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "org_id",
+ "description": "Unique identifier of an organization.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ }
+ },
+ "/enterprises/{enterprise}/actions/permissions/selected-actions": {
+ "get": {
+ "summary": "Get allowed actions for an enterprise",
+ "description": "Gets the selected actions that are allowed in an enterprise. To use this endpoint, the enterprise permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/get-allowed-actions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#get-allowed-actions-for-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "github_owned_allowed": {
+ "type": "boolean",
+ "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+ },
+ "verified_allowed": {
+ "type": "boolean",
+ "description": "Whether actions in GitHub Marketplace from verified creators are allowed. Set to `true` to allow all GitHub Marketplace actions by verified creators."
+ },
+ "patterns_allowed": {
+ "type": "array",
+ "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "github_owned_allowed": true,
+ "verified_allowed": false,
+ "patterns_allowed": [
+ "monalisa/octocat@*",
+ "docker/*"
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ },
+ "put": {
+ "summary": "Set allowed actions for an enterprise",
+ "description": "Sets the actions that are allowed in an enterprise. To use this endpoint, the enterprise permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+ "operationId": "enterprise-admin/set-allowed-actions-enterprise",
+ "tags": [
+ "enterprise-admin"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/enterprise-admin#set-allowed-actions-for-an-enterprise"
+ },
+ "parameters": [
+ {
+ "name": "enterprise",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "github_owned_allowed": {
+ "type": "boolean",
+ "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+ },
+ "verified_allowed": {
+ "type": "boolean",
+ "description": "Whether actions in GitHub Marketplace from verified creators are allowed. Set to `true` to allow all GitHub Marketplace actions by verified creators."
+ },
+ "patterns_allowed": {
+ "type": "array",
+ "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "examples": {
+ "selected_actions": {
+ "value": {
+ "github_owned_allowed": true,
+ "verified_allowed": false,
+ "patterns_allowed": [
+ "monalisa/octocat@*",
+ "docker/*"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": false,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "enterprise-admin",
+ "subcategory": "actions"
+ }
+ }
+ },
"/enterprises/{enterprise}/actions/runner-groups": {
"get": {
"summary": "List self-hosted runner groups for an enterprise",
@@ -12147,7 +12780,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12271,7 +12904,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12403,7 +13036,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12488,7 +13121,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12601,7 +13234,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12649,7 +13282,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12824,7 +13457,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12900,7 +13533,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -12955,7 +13588,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13012,7 +13645,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13223,7 +13856,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13299,7 +13932,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13354,7 +13987,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13411,7 +14044,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13615,7 +14248,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -13716,7 +14349,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -14778,7 +15411,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -15840,7 +16473,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -15985,7 +16618,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -16033,7 +16666,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -16124,7 +16757,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -16193,7 +16826,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -40254,6 +40887,1629 @@
}
}
},
+ "/orgs/{org}/actions/permissions": {
+ "get": {
+ "summary": "Get GitHub Actions permissions for an organization",
+ "description": "Gets the GitHub Actions permissions policy for repositories and allowed actions in an organization.\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/get-github-actions-permissions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#get-github-actions-permissions-for-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "enabled_repositories": {
+ "type": "string",
+ "description": "The policy that controls the repositories in the organization that are allowed to run GitHub Actions. Can be one of: `all`, `none`, or `selected`.",
+ "enum": [
+ "all",
+ "none",
+ "selected"
+ ]
+ },
+ "selected_repositories_url": {
+ "type": "string",
+ "description": "The API URL to use to get or set the selected repositories that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`."
+ },
+ "allowed_actions": {
+ "type": "string",
+ "description": "The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.",
+ "enum": [
+ "all",
+ "local_only",
+ "selected"
+ ]
+ },
+ "selected_actions_url": {
+ "type": "string",
+ "description": "The API URL to use to get or set the actions that are allowed to run, when `allowed_actions` is set to `selected`."
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "enabled_repositories": "all",
+ "allowed_actions": "selected",
+ "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ },
+ "put": {
+ "summary": "Set GitHub Actions permissions for an organization",
+ "description": "Sets the GitHub Actions permissions policy for repositories and allowed actions in an organization.\n\nIf the organization belongs to an enterprise that has set restrictive permissions at the enterprise level, such as `allowed_actions` to `selected` actions, then you cannot override them for the organization.\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/set-github-actions-permissions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#set-github-actions-permissions-for-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "enabled_repositories": {
+ "type": "string",
+ "description": "The policy that controls the repositories in the organization that are allowed to run GitHub Actions. Can be one of: `all`, `none`, or `selected`.",
+ "enum": [
+ "all",
+ "none",
+ "selected"
+ ]
+ },
+ "allowed_actions": {
+ "type": "string",
+ "description": "The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.",
+ "enum": [
+ "all",
+ "local_only",
+ "selected"
+ ]
+ }
+ },
+ "required": [
+ "enabled_repositories"
+ ]
+ },
+ "example": {
+ "enabled_repositories": "all",
+ "allowed_actions": "selected"
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ }
+ },
+ "/orgs/{org}/actions/permissions/repositories": {
+ "get": {
+ "summary": "List selected repositories enabled for GitHub Actions in an organization",
+ "description": "Lists the selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/list-selected-repositories-enabled-github-actions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#list-selected-repositories-enabled-for-github-actions-in-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "per_page",
+ "description": "Results per page (max 100)",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 30
+ }
+ },
+ {
+ "name": "page",
+ "description": "Page number of the results to fetch.",
+ "in": "query",
+ "schema": {
+ "type": "integer",
+ "default": 1
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "total_count": {
+ "type": "number"
+ },
+ "repositories": {
+ "type": "array",
+ "items": {
+ "title": "Repository",
+ "description": "A git repository",
+ "type": "object",
+ "properties": {
+ "id": {
+ "description": "Unique identifier of the repository",
+ "example": 42,
+ "type": "integer"
+ },
+ "node_id": {
+ "type": "string",
+ "example": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5"
+ },
+ "name": {
+ "description": "The name of the repository.",
+ "type": "string",
+ "example": "Team Environment"
+ },
+ "full_name": {
+ "type": "string",
+ "example": "octocat/Hello-World"
+ },
+ "license": {
+ "nullable": true,
+ "allOf": [
+ {
+ "title": "License Simple",
+ "description": "License Simple",
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "example": "mit"
+ },
+ "name": {
+ "type": "string",
+ "example": "MIT License"
+ },
+ "url": {
+ "type": "string",
+ "nullable": true,
+ "format": "uri",
+ "example": "https://api.github.com/licenses/mit"
+ },
+ "spdx_id": {
+ "type": "string",
+ "nullable": true,
+ "example": "MIT"
+ },
+ "node_id": {
+ "type": "string",
+ "example": "MDc6TGljZW5zZW1pdA=="
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri"
+ }
+ },
+ "required": [
+ "key",
+ "name",
+ "url",
+ "spdx_id",
+ "node_id"
+ ]
+ }
+ ]
+ },
+ "forks": {
+ "type": "integer"
+ },
+ "permissions": {
+ "type": "object",
+ "properties": {
+ "admin": {
+ "type": "boolean"
+ },
+ "pull": {
+ "type": "boolean"
+ },
+ "triage": {
+ "type": "boolean"
+ },
+ "push": {
+ "type": "boolean"
+ },
+ "maintain": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "admin",
+ "pull",
+ "push"
+ ]
+ },
+ "owner": {
+ "nullable": true,
+ "allOf": [
+ {
+ "title": "Simple User",
+ "description": "Simple User",
+ "type": "object",
+ "properties": {
+ "login": {
+ "type": "string",
+ "example": "octocat"
+ },
+ "id": {
+ "type": "integer",
+ "example": 1
+ },
+ "node_id": {
+ "type": "string",
+ "example": "MDQ6VXNlcjE="
+ },
+ "avatar_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://github.com/images/error/octocat_happy.gif"
+ },
+ "gravatar_id": {
+ "type": "string",
+ "example": "",
+ "nullable": true
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/users/octocat"
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://github.com/octocat"
+ },
+ "followers_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/users/octocat/followers"
+ },
+ "following_url": {
+ "type": "string",
+ "example": "https://api.github.com/users/octocat/following{/other_user}"
+ },
+ "gists_url": {
+ "type": "string",
+ "example": "https://api.github.com/users/octocat/gists{/gist_id}"
+ },
+ "starred_url": {
+ "type": "string",
+ "example": "https://api.github.com/users/octocat/starred{/owner}{/repo}"
+ },
+ "subscriptions_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/users/octocat/subscriptions"
+ },
+ "organizations_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/users/octocat/orgs"
+ },
+ "repos_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/users/octocat/repos"
+ },
+ "events_url": {
+ "type": "string",
+ "example": "https://api.github.com/users/octocat/events{/privacy}"
+ },
+ "received_events_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/users/octocat/received_events"
+ },
+ "type": {
+ "type": "string",
+ "example": "User"
+ },
+ "site_admin": {
+ "type": "boolean"
+ },
+ "starred_at": {
+ "type": "string",
+ "example": "\"2020-07-09T00:17:55Z\""
+ }
+ },
+ "required": [
+ "avatar_url",
+ "events_url",
+ "followers_url",
+ "following_url",
+ "gists_url",
+ "gravatar_id",
+ "html_url",
+ "id",
+ "node_id",
+ "login",
+ "organizations_url",
+ "received_events_url",
+ "repos_url",
+ "site_admin",
+ "starred_url",
+ "subscriptions_url",
+ "type",
+ "url"
+ ],
+ "nullable": true
+ }
+ ]
+ },
+ "private": {
+ "description": "Whether the repository is private or public.",
+ "default": false,
+ "type": "boolean"
+ },
+ "html_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://github.com/octocat/Hello-World"
+ },
+ "description": {
+ "type": "string",
+ "example": "This your first repo!",
+ "nullable": true
+ },
+ "fork": {
+ "type": "boolean"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://api.github.com/repos/octocat/Hello-World"
+ },
+ "archive_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}"
+ },
+ "assignees_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/assignees{/user}"
+ },
+ "blobs_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}"
+ },
+ "branches_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/branches{/branch}"
+ },
+ "collaborators_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}"
+ },
+ "comments_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/comments{/number}"
+ },
+ "commits_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/commits{/sha}"
+ },
+ "compare_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}"
+ },
+ "contents_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/contents/{+path}"
+ },
+ "contributors_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/contributors"
+ },
+ "deployments_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/deployments"
+ },
+ "downloads_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/downloads"
+ },
+ "events_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/events"
+ },
+ "forks_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/forks"
+ },
+ "git_commits_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}"
+ },
+ "git_refs_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}"
+ },
+ "git_tags_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}"
+ },
+ "git_url": {
+ "type": "string",
+ "example": "git:github.com/octocat/Hello-World.git"
+ },
+ "issue_comment_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}"
+ },
+ "issue_events_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/issues/events{/number}"
+ },
+ "issues_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/issues{/number}"
+ },
+ "keys_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/keys{/key_id}"
+ },
+ "labels_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/labels{/name}"
+ },
+ "languages_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/languages"
+ },
+ "merges_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/merges"
+ },
+ "milestones_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/milestones{/number}"
+ },
+ "notifications_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}"
+ },
+ "pulls_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/pulls{/number}"
+ },
+ "releases_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/releases{/id}"
+ },
+ "ssh_url": {
+ "type": "string",
+ "example": "git@github.com:octocat/Hello-World.git"
+ },
+ "stargazers_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/stargazers"
+ },
+ "statuses_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/statuses/{sha}"
+ },
+ "subscribers_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/subscribers"
+ },
+ "subscription_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/subscription"
+ },
+ "tags_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/tags"
+ },
+ "teams_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/teams"
+ },
+ "trees_url": {
+ "type": "string",
+ "example": "http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}"
+ },
+ "clone_url": {
+ "type": "string",
+ "example": "https://github.com/octocat/Hello-World.git"
+ },
+ "mirror_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "git:git.example.com/octocat/Hello-World",
+ "nullable": true
+ },
+ "hooks_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "http://api.github.com/repos/octocat/Hello-World/hooks"
+ },
+ "svn_url": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://svn.github.com/octocat/Hello-World"
+ },
+ "homepage": {
+ "type": "string",
+ "format": "uri",
+ "example": "https://github.com",
+ "nullable": true
+ },
+ "language": {
+ "type": "string",
+ "nullable": true
+ },
+ "forks_count": {
+ "type": "integer",
+ "example": 9
+ },
+ "stargazers_count": {
+ "type": "integer",
+ "example": 80
+ },
+ "watchers_count": {
+ "type": "integer",
+ "example": 80
+ },
+ "size": {
+ "type": "integer",
+ "example": 108
+ },
+ "default_branch": {
+ "description": "The default branch of the repository.",
+ "type": "string",
+ "example": "master"
+ },
+ "open_issues_count": {
+ "type": "integer",
+ "example": 0
+ },
+ "is_template": {
+ "description": "Whether this repository acts as a template that can be used to generate new repositories.",
+ "default": false,
+ "type": "boolean",
+ "example": true
+ },
+ "topics": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "has_issues": {
+ "description": "Whether issues are enabled.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "has_projects": {
+ "description": "Whether projects are enabled.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "has_wiki": {
+ "description": "Whether the wiki is enabled.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "has_pages": {
+ "type": "boolean"
+ },
+ "has_downloads": {
+ "description": "Whether downloads are enabled.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "archived": {
+ "description": "Whether the repository is archived.",
+ "default": false,
+ "type": "boolean"
+ },
+ "disabled": {
+ "type": "boolean",
+ "description": "Returns whether or not this repository disabled."
+ },
+ "visibility": {
+ "description": "The repository visibility: public, private, or internal.",
+ "default": "public",
+ "type": "string"
+ },
+ "pushed_at": {
+ "type": "string",
+ "format": "date-time",
+ "example": "2011-01-26T19:06:43Z",
+ "nullable": true
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "example": "2011-01-26T19:01:12Z",
+ "nullable": true
+ },
+ "updated_at": {
+ "type": "string",
+ "format": "date-time",
+ "example": "2011-01-26T19:14:43Z",
+ "nullable": true
+ },
+ "allow_rebase_merge": {
+ "description": "Whether to allow rebase merges for pull requests.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "template_repository": {
+ "type": "object",
+ "nullable": true,
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "node_id": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "full_name": {
+ "type": "string"
+ },
+ "owner": {
+ "type": "object",
+ "properties": {
+ "login": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "node_id": {
+ "type": "string"
+ },
+ "avatar_url": {
+ "type": "string"
+ },
+ "gravatar_id": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ },
+ "html_url": {
+ "type": "string"
+ },
+ "followers_url": {
+ "type": "string"
+ },
+ "following_url": {
+ "type": "string"
+ },
+ "gists_url": {
+ "type": "string"
+ },
+ "starred_url": {
+ "type": "string"
+ },
+ "subscriptions_url": {
+ "type": "string"
+ },
+ "organizations_url": {
+ "type": "string"
+ },
+ "repos_url": {
+ "type": "string"
+ },
+ "events_url": {
+ "type": "string"
+ },
+ "received_events_url": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "site_admin": {
+ "type": "boolean"
+ }
+ }
+ },
+ "private": {
+ "type": "boolean"
+ },
+ "html_url": {
+ "type": "string"
+ },
+ "description": {
+ "type": "string"
+ },
+ "fork": {
+ "type": "boolean"
+ },
+ "url": {
+ "type": "string"
+ },
+ "archive_url": {
+ "type": "string"
+ },
+ "assignees_url": {
+ "type": "string"
+ },
+ "blobs_url": {
+ "type": "string"
+ },
+ "branches_url": {
+ "type": "string"
+ },
+ "collaborators_url": {
+ "type": "string"
+ },
+ "comments_url": {
+ "type": "string"
+ },
+ "commits_url": {
+ "type": "string"
+ },
+ "compare_url": {
+ "type": "string"
+ },
+ "contents_url": {
+ "type": "string"
+ },
+ "contributors_url": {
+ "type": "string"
+ },
+ "deployments_url": {
+ "type": "string"
+ },
+ "downloads_url": {
+ "type": "string"
+ },
+ "events_url": {
+ "type": "string"
+ },
+ "forks_url": {
+ "type": "string"
+ },
+ "git_commits_url": {
+ "type": "string"
+ },
+ "git_refs_url": {
+ "type": "string"
+ },
+ "git_tags_url": {
+ "type": "string"
+ },
+ "git_url": {
+ "type": "string"
+ },
+ "issue_comment_url": {
+ "type": "string"
+ },
+ "issue_events_url": {
+ "type": "string"
+ },
+ "issues_url": {
+ "type": "string"
+ },
+ "keys_url": {
+ "type": "string"
+ },
+ "labels_url": {
+ "type": "string"
+ },
+ "languages_url": {
+ "type": "string"
+ },
+ "merges_url": {
+ "type": "string"
+ },
+ "milestones_url": {
+ "type": "string"
+ },
+ "notifications_url": {
+ "type": "string"
+ },
+ "pulls_url": {
+ "type": "string"
+ },
+ "releases_url": {
+ "type": "string"
+ },
+ "ssh_url": {
+ "type": "string"
+ },
+ "stargazers_url": {
+ "type": "string"
+ },
+ "statuses_url": {
+ "type": "string"
+ },
+ "subscribers_url": {
+ "type": "string"
+ },
+ "subscription_url": {
+ "type": "string"
+ },
+ "tags_url": {
+ "type": "string"
+ },
+ "teams_url": {
+ "type": "string"
+ },
+ "trees_url": {
+ "type": "string"
+ },
+ "clone_url": {
+ "type": "string"
+ },
+ "mirror_url": {
+ "type": "string"
+ },
+ "hooks_url": {
+ "type": "string"
+ },
+ "svn_url": {
+ "type": "string"
+ },
+ "homepage": {
+ "type": "string"
+ },
+ "language": {
+ "type": "string"
+ },
+ "forks_count": {
+ "type": "integer"
+ },
+ "stargazers_count": {
+ "type": "integer"
+ },
+ "watchers_count": {
+ "type": "integer"
+ },
+ "size": {
+ "type": "integer"
+ },
+ "default_branch": {
+ "type": "string"
+ },
+ "open_issues_count": {
+ "type": "integer"
+ },
+ "is_template": {
+ "type": "boolean"
+ },
+ "topics": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "has_issues": {
+ "type": "boolean"
+ },
+ "has_projects": {
+ "type": "boolean"
+ },
+ "has_wiki": {
+ "type": "boolean"
+ },
+ "has_pages": {
+ "type": "boolean"
+ },
+ "has_downloads": {
+ "type": "boolean"
+ },
+ "archived": {
+ "type": "boolean"
+ },
+ "disabled": {
+ "type": "boolean"
+ },
+ "visibility": {
+ "type": "string"
+ },
+ "pushed_at": {
+ "type": "string"
+ },
+ "created_at": {
+ "type": "string"
+ },
+ "updated_at": {
+ "type": "string"
+ },
+ "permissions": {
+ "type": "object",
+ "properties": {
+ "admin": {
+ "type": "boolean"
+ },
+ "push": {
+ "type": "boolean"
+ },
+ "pull": {
+ "type": "boolean"
+ }
+ }
+ },
+ "allow_rebase_merge": {
+ "type": "boolean"
+ },
+ "template_repository": {
+ "type": "string"
+ },
+ "temp_clone_token": {
+ "type": "string"
+ },
+ "allow_squash_merge": {
+ "type": "boolean"
+ },
+ "delete_branch_on_merge": {
+ "type": "boolean"
+ },
+ "allow_merge_commit": {
+ "type": "boolean"
+ },
+ "subscribers_count": {
+ "type": "integer"
+ },
+ "network_count": {
+ "type": "integer"
+ }
+ }
+ },
+ "temp_clone_token": {
+ "type": "string"
+ },
+ "allow_squash_merge": {
+ "description": "Whether to allow squash merges for pull requests.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "delete_branch_on_merge": {
+ "description": "Whether to delete head branches when pull requests are merged",
+ "default": false,
+ "type": "boolean",
+ "example": false
+ },
+ "allow_merge_commit": {
+ "description": "Whether to allow merge commits for pull requests.",
+ "default": true,
+ "type": "boolean",
+ "example": true
+ },
+ "subscribers_count": {
+ "type": "integer"
+ },
+ "network_count": {
+ "type": "integer"
+ },
+ "open_issues": {
+ "type": "integer"
+ },
+ "watchers": {
+ "type": "integer"
+ },
+ "master_branch": {
+ "type": "string"
+ },
+ "starred_at": {
+ "type": "string",
+ "example": "\"2020-07-09T00:17:42Z\""
+ }
+ },
+ "required": [
+ "archive_url",
+ "assignees_url",
+ "blobs_url",
+ "branches_url",
+ "collaborators_url",
+ "comments_url",
+ "commits_url",
+ "compare_url",
+ "contents_url",
+ "contributors_url",
+ "deployments_url",
+ "description",
+ "downloads_url",
+ "events_url",
+ "fork",
+ "forks_url",
+ "full_name",
+ "git_commits_url",
+ "git_refs_url",
+ "git_tags_url",
+ "hooks_url",
+ "html_url",
+ "id",
+ "node_id",
+ "issue_comment_url",
+ "issue_events_url",
+ "issues_url",
+ "keys_url",
+ "labels_url",
+ "languages_url",
+ "merges_url",
+ "milestones_url",
+ "name",
+ "notifications_url",
+ "owner",
+ "private",
+ "pulls_url",
+ "releases_url",
+ "stargazers_url",
+ "statuses_url",
+ "subscribers_url",
+ "subscription_url",
+ "tags_url",
+ "teams_url",
+ "trees_url",
+ "url",
+ "clone_url",
+ "default_branch",
+ "forks",
+ "forks_count",
+ "git_url",
+ "has_downloads",
+ "has_issues",
+ "has_projects",
+ "has_wiki",
+ "has_pages",
+ "homepage",
+ "language",
+ "archived",
+ "disabled",
+ "mirror_url",
+ "open_issues",
+ "open_issues_count",
+ "license",
+ "pushed_at",
+ "size",
+ "ssh_url",
+ "stargazers_count",
+ "svn_url",
+ "watchers",
+ "watchers_count",
+ "created_at",
+ "updated_at"
+ ]
+ }
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "total_count": 1,
+ "repositories": [
+ {
+ "id": 1296269,
+ "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
+ "name": "Hello-World",
+ "full_name": "octocat/Hello-World",
+ "owner": {
+ "login": "octocat",
+ "id": 1,
+ "node_id": "MDQ6VXNlcjE=",
+ "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+ "gravatar_id": "",
+ "url": "https://api.github.com/users/octocat",
+ "html_url": "https://github.com/octocat",
+ "followers_url": "https://api.github.com/users/octocat/followers",
+ "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+ "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+ "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+ "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+ "organizations_url": "https://api.github.com/users/octocat/orgs",
+ "repos_url": "https://api.github.com/users/octocat/repos",
+ "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+ "received_events_url": "https://api.github.com/users/octocat/received_events",
+ "type": "User",
+ "site_admin": false
+ },
+ "private": false,
+ "html_url": "https://github.com/octocat/Hello-World",
+ "description": "This your first repo!",
+ "fork": false,
+ "url": "https://api.github.com/repos/octocat/Hello-World",
+ "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
+ "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
+ "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
+ "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
+ "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
+ "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
+ "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
+ "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
+ "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
+ "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
+ "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
+ "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
+ "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
+ "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
+ "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
+ "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
+ "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
+ "git_url": "git:github.com/octocat/Hello-World.git",
+ "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
+ "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
+ "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
+ "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
+ "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
+ "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
+ "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
+ "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
+ "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
+ "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
+ "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
+ "ssh_url": "git@github.com:octocat/Hello-World.git",
+ "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
+ "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
+ "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
+ "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
+ "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
+ "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
+ "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
+ "clone_url": "https://github.com/octocat/Hello-World.git",
+ "mirror_url": "git:git.example.com/octocat/Hello-World",
+ "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks",
+ "svn_url": "https://svn.github.com/octocat/Hello-World",
+ "homepage": "https://github.com",
+ "language": null,
+ "forks_count": 9,
+ "stargazers_count": 80,
+ "watchers_count": 80,
+ "size": 108,
+ "default_branch": "master",
+ "open_issues_count": 0,
+ "is_template": true,
+ "topics": [
+ "octocat",
+ "atom",
+ "electron",
+ "api"
+ ],
+ "has_issues": true,
+ "has_projects": true,
+ "has_wiki": true,
+ "has_pages": false,
+ "has_downloads": true,
+ "archived": false,
+ "disabled": false,
+ "visibility": "public",
+ "pushed_at": "2011-01-26T19:06:43Z",
+ "created_at": "2011-01-26T19:01:12Z",
+ "updated_at": "2011-01-26T19:14:43Z",
+ "permissions": {
+ "admin": false,
+ "push": false,
+ "pull": true
+ },
+ "allow_rebase_merge": true,
+ "template_repository": null,
+ "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O",
+ "allow_squash_merge": true,
+ "delete_branch_on_merge": true,
+ "allow_merge_commit": true,
+ "subscribers_count": 42,
+ "network_count": 0,
+ "license": {
+ "key": "mit",
+ "name": "MIT License",
+ "url": "https://api.github.com/licenses/mit",
+ "spdx_id": "MIT",
+ "node_id": "MDc6TGljZW5zZW1pdA==",
+ "html_url": "https://github.com/licenses/mit"
+ },
+ "forks": 1,
+ "open_issues": 1,
+ "watchers": 1
+ }
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ },
+ "put": {
+ "summary": "Set selected repositories enabled for GitHub Actions in an organization",
+ "description": "Replaces the list of selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/set-selected-repositories-enabled-github-actions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#set-selected-repositories-enabled-for-github-actions-in-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "selected_repository_ids": {
+ "description": "List of repository IDs to enable for GitHub Actions.",
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "description": "Unique identifier of the repository."
+ }
+ }
+ },
+ "required": [
+ "selected_repository_ids"
+ ]
+ },
+ "example": {
+ "selected_repository_ids": [
+ 32,
+ 42
+ ]
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ }
+ },
+ "/orgs/{org}/actions/permissions/repositories/{repository_id}": {
+ "put": {
+ "summary": "Enable a selected repository for GitHub Actions in an organization",
+ "description": "Adds a repository to the list of selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/enable-selected-repository-github-actions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#enable-a-selected-repository-for-github-actions-in-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repository_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ },
+ "delete": {
+ "summary": "Disable a selected repository for GitHub Actions in an organization",
+ "description": "Removes a repository from the list of selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/disable-selected-repository-github-actions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#disable-a-selected-repository-for-github-actions-in-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repository_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ }
+ },
+ "/orgs/{org}/actions/permissions/selected-actions": {
+ "get": {
+ "summary": "Get allowed actions for an organization",
+ "description": "Gets the selected actions that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\"\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/get-allowed-actions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#get-allowed-actions-for-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "github_owned_allowed": {
+ "type": "boolean",
+ "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+ },
+ "verified_allowed": {
+ "type": "boolean",
+ "description": "Whether actions in GitHub Marketplace from verified creators are allowed. Set to `true` to allow all GitHub Marketplace actions by verified creators."
+ },
+ "patterns_allowed": {
+ "type": "array",
+ "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "github_owned_allowed": true,
+ "verified_allowed": false,
+ "patterns_allowed": [
+ "monalisa/octocat@*",
+ "docker/*"
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ },
+ "put": {
+ "summary": "Set allowed actions for an organization",
+ "description": "Sets the actions that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\n\nIf the organization belongs to an enterprise that has `selected` actions set at the enterprise level, then you cannot override any of the enterprise's allowed actions settings.\n\nTo use the `patterns_allowed` setting for private repositories, the organization must belong to an enterprise. If the organization does not belong to an enterprise, then the `patterns_allowed` setting only applies to public repositories in the organization.\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+ "operationId": "actions/set-allowed-actions-organization",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#set-allowed-actions-for-an-organization"
+ },
+ "parameters": [
+ {
+ "name": "org",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "github_owned_allowed": {
+ "type": "boolean",
+ "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+ },
+ "verified_allowed": {
+ "type": "boolean",
+ "description": "Whether actions in GitHub Marketplace from verified creators are allowed. Set to `true` to allow all GitHub Marketplace actions by verified creators."
+ },
+ "patterns_allowed": {
+ "type": "array",
+ "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "examples": {
+ "selected_actions": {
+ "value": {
+ "github_owned_allowed": true,
+ "verified_allowed": false,
+ "patterns_allowed": [
+ "monalisa/octocat@*",
+ "docker/*"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ }
+ },
"/orgs/{org}/actions/runner-groups": {
"get": {
"summary": "List self-hosted runner groups for an organization",
@@ -92261,6 +94517,326 @@
}
}
},
+ "/repos/{owner}/{repo}/actions/permissions": {
+ "get": {
+ "summary": "Get GitHub Actions permissions for a repository",
+ "description": "Gets the GitHub Actions permissions policy for a repository, including whether GitHub Actions is enabled and the actions allowed to run in the repository.\n\nYou must authenticate using an access token with the `repo` scope to use this\nendpoint. GitHub Apps must have the `administration` repository permission to use this API.",
+ "operationId": "actions/get-github-actions-permissions-repository",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#get-github-actions-permissions-for-a-repository"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "enabled": {
+ "type": "boolean",
+ "description": "Whether GitHub Actions is enabled on the repository."
+ },
+ "allowed_actions": {
+ "type": "string",
+ "description": "The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.",
+ "enum": [
+ "all",
+ "local_only",
+ "selected"
+ ]
+ },
+ "selected_actions_url": {
+ "type": "string",
+ "description": "The API URL to use to get or set the actions that are allowed to run, when `allowed_actions` is set to `selected`."
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "enabled": true,
+ "allowed_actions": "selected",
+ "selected_actions_url": "https://api.github.com/repositories/42/actions/permissions/selected-actions"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ },
+ "put": {
+ "summary": "Set GitHub Actions permissions for a repository",
+ "description": "Sets the GitHub Actions permissions policy for enabling GitHub Actions and allowed actions in the repository.\n\nIf the repository belongs to an organization or enterprise that has set restrictive permissions at the organization or enterprise levels, such as `allowed_actions` to `selected` actions, then you cannot override them for the repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API.",
+ "operationId": "actions/set-github-actions-permissions-repository",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#set-github-actions-permissions-for-a-repository"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "enabled": {
+ "type": "boolean",
+ "description": "Whether GitHub Actions is enabled on the repository."
+ },
+ "allowed_actions": {
+ "type": "string",
+ "description": "The permissions policy that controls the actions that are allowed to run. Can be one of: `all`, `local_only`, or `selected`.",
+ "enum": [
+ "all",
+ "local_only",
+ "selected"
+ ]
+ }
+ },
+ "required": [
+ "enabled"
+ ]
+ },
+ "example": {
+ "enabled": true,
+ "allowed_actions": "selected"
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ }
+ },
+ "/repos/{owner}/{repo}/actions/permissions/selected-actions": {
+ "get": {
+ "summary": "Get allowed actions for a repository",
+ "description": "Gets the settings for selected actions that are allowed in a repository. To use this endpoint, the repository policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository).\"\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API.",
+ "operationId": "actions/get-allowed-actions-repository",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#get-allowed-actions-for-a-repository"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "github_owned_allowed": {
+ "type": "boolean",
+ "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+ },
+ "verified_allowed": {
+ "type": "boolean",
+ "description": "Whether actions in GitHub Marketplace from verified creators are allowed. Set to `true` to allow all GitHub Marketplace actions by verified creators."
+ },
+ "patterns_allowed": {
+ "type": "array",
+ "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "examples": {
+ "default": {
+ "value": {
+ "github_owned_allowed": true,
+ "verified_allowed": false,
+ "patterns_allowed": [
+ "monalisa/octocat@*",
+ "docker/*"
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ },
+ "put": {
+ "summary": "Set allowed actions for a repository",
+ "description": "Sets the actions that are allowed in a repository. To use this endpoint, the repository permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository).\"\n\nIf the repository belongs to an organization or enterprise that has `selected` actions set at the organization or enterprise levels, then you cannot override any of the allowed actions settings.\n\nTo use the `patterns_allowed` setting for private repositories, the repository must belong to an enterprise. If the repository does not belong to an enterprise, then the `patterns_allowed` setting only applies to public repositories.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API.",
+ "operationId": "actions/set-allowed-actions-repository",
+ "tags": [
+ "actions"
+ ],
+ "externalDocs": {
+ "description": "API method documentation",
+ "url": "https://developer.github.com/rest/reference/actions#set-allowed-actions-for-a-repository"
+ },
+ "parameters": [
+ {
+ "name": "owner",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "repo",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "Empty response"
+ }
+ },
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "github_owned_allowed": {
+ "type": "boolean",
+ "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+ },
+ "verified_allowed": {
+ "type": "boolean",
+ "description": "Whether actions in GitHub Marketplace from verified creators are allowed. Set to `true` to allow all GitHub Marketplace actions by verified creators."
+ },
+ "patterns_allowed": {
+ "type": "array",
+ "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "examples": {
+ "selected_actions": {
+ "value": {
+ "github_owned_allowed": true,
+ "verified_allowed": false,
+ "patterns_allowed": [
+ "monalisa/octocat@*",
+ "docker/*"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "x-github": {
+ "enabledForGitHubApps": true,
+ "githubCloudOnly": false,
+ "previews": [
+
+ ],
+ "category": "actions",
+ "subcategory": "permissions"
+ }
+ }
+ },
"/repos/{owner}/{repo}/actions/runners": {
"get": {
"summary": "List self-hosted runners for a repository",
@@ -231618,7 +234194,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -231816,7 +234392,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -231999,7 +234575,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -232134,7 +234710,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -232324,7 +234900,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -232499,7 +235075,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -232547,7 +235123,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -232782,7 +235358,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -233044,7 +235620,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -233208,7 +235784,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -233477,7 +236053,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {
@@ -233696,7 +236272,7 @@
"parameters": [
{
"name": "enterprise",
- "description": "Unique identifier of the GitHub Enterprise Cloud instance.",
+ "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
"in": "path",
"required": true,
"schema": {