app_access_restrictions

Overview

Name	app_access_restrictions
Type	Resource
Id	github.repos.app_access_restrictions

Fields

Name	Datatype	Description
id	integer	Unique identifier of the GitHub app
name	string	The name of the GitHub app
description	string
slug	string	The slug name of the GitHub app
client_secret	string
pem	string
html_url	string
client_id	string
webhook_secret	string
node_id	string
external_url	string
updated_at	string
permissions	object	The set of permissions for the GitHub app
owner	object	A GitHub user.
installations_count	integer	The number of installations associated with the GitHub app
events	array	The list of events for the GitHub app
created_at	string

Methods

Name	Accessible by	Required Params	Description
get_apps_with_access_to_protected_branch	SELECT	branch, owner, repo	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 GitHub's products in the GitHub Help documentation. Lists the GitHub Apps that have push access to this branch. Only installed GitHub Apps with write access to the contents permission can be added as authorized actors on a protected branch.
add_app_access_restrictions	INSERT	branch, owner, repo	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 GitHub's products in the GitHub Help documentation. Grants the specified apps push access for this branch. Only installed GitHub Apps with write access to the contents permission can be added as authorized actors on a protected branch.
remove_app_access_restrictions	DELETE	branch, owner, repo	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 GitHub's products in the GitHub Help documentation. Removes the ability of an app to push to this branch. Only installed GitHub Apps with write access to the contents permission can be added as authorized actors on a protected branch.
set_app_access_restrictions	EXEC	branch, owner, repo	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 GitHub's products in the GitHub Help documentation. Replaces the list of apps that have push access to this branch. This removes all apps that previously had push access and grants push access to the new list of apps. Only installed GitHub Apps with write access to the contents permission can be added as authorized actors on a protected branch.