orgstringrequired
Set GitHub Actions permissions for an organization
Sets the GitHub Actions permissions policy for repositories and allowed actions in an organization.
If 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.
You 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.
put
{protocol}://{hostname}/api/v3/orgs/{org}/actions/permissions
Path Parameters
Body
application/json
Body
application/json
enabled_repositoriesstringrequired
The policy that controls the repositories in the organization that are allowed to run GitHub Actions. Can be one of: all, none, or selected.
Allowed values:allnoneselected
allowed_actionsstring
The permissions policy that controls the actions that are allowed to run. Can be one of: all, local_only, or selected.
Allowed values:alllocal_onlyselected
Response
204
Response
204
Response
put/orgs/{org}/actions/permissions
Path Parameters
Body
{
"enabled_repositories": "all",
"allowed_actions": "selected"
}
204
List selected repositories enabled for GitHub Actions in an organization
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.”
You 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.
get
{protocol}://{hostname}/api/v3/orgs/{org}/actions/permissions/repositories
Query Parameters
per_pageinteger
Results per page (max 100)
Default:30
pageinteger
Page number of the results to fetch.
Default:1
Path Parameters
orgstringrequired
Response
200 application/json
Response
200 application/json
Response
total_countnumberrequired
repositoriesarray[object]required
A git repository
Show Child Parameters
get/orgs/{org}/actions/permissions/repositories
Path Parameters
Query Parameters
200 application/json
Set selected repositories enabled for GitHub Actions in an organization
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.”
You 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.
put
{protocol}://{hostname}/api/v3/orgs/{org}/actions/permissions/repositories
Path Parameters
orgstringrequired
Body
application/json
Body
application/json
selected_repository_idsarray[integer]required
Unique identifier of the repository.
Response
204
Response
204
Response
put/orgs/{org}/actions/permissions/repositories
Path Parameters
Body
{
"selected_repository_ids": [
32,
42
]
}
204
Enable a selected repository for GitHub Actions in an organization
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.”
You 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.
put
{protocol}://{hostname}/api/v3/orgs/{org}/actions/permissions/repositories/{repository_id}
Path Parameters
orgstringrequired
repository_idintegerrequired
Response
204
Response
204
Response
put/orgs/{org}/actions/permissions/repositories/{repository_id}
Path Parameters
204
Disable a selected repository for GitHub Actions in an organization
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.”
You 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.
delete
{protocol}://{hostname}/api/v3/orgs/{org}/actions/permissions/repositories/{repository_id}
Path Parameters
orgstringrequired
repository_idintegerrequired
Response
204
Response
204
Response
delete/orgs/{org}/actions/permissions/repositories/{repository_id}
Path Parameters
204