installations

Overview

Name	installations
Type	Resource
Id	github.apps.installations

Fields

Name	Datatype	Description
id	integer	The ID of the installation.
suspended_by	object	Simple User
permissions	object	The permissions granted to the user-to-server access token.
single_file_paths	array
updated_at	string
repositories_url	string
account	``
repository_selection	string	Describe whether all repositories have been selected or there's a selection involved
created_at	string
target_type	string
single_file_name	string
contact_email	string
access_tokens_url	string
app_id	integer
target_id	integer	The ID of the user or organization this token is being scoped to.
html_url	string
suspended_at	string
has_multiple_single_files	boolean
events	array
app_slug	string

Methods

Name	Accessible by	Required Params	Description
get_installation	SELECT	installation_id	Enables an authenticated GitHub App to find an installation's information using the installation id. You must use a JWT to access this endpoint.
get_org_installation	SELECT	org	Enables an authenticated GitHub App to find the organization's installation information. You must use a JWT to access this endpoint.
get_repo_installation	SELECT	owner, repo	Enables an authenticated GitHub App to find the repository's installation information. The installation's account type will be either an organization or a user account, depending which account the repository belongs to. You must use a JWT to access this endpoint.
list_installations	SELECT		You must use a JWT to access this endpoint. The permissions the installation has are included under the permissions key.
delete_installation	DELETE	installation_id	Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the "Suspend an app installation" endpoint. You must use a JWT to access this endpoint.
create_installation_access_token	EXEC	installation_id	Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of 401 - Unauthorized, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. To restrict the access to specific repositories, you can provide the repository_ids when creating the token. When you omit repository_ids, the response does not contain the repositories key. You must use a JWT to access this endpoint.
suspend_installation	EXEC	installation_id	Suspends a GitHub App on a user, organization, or business account, which blocks the app from accessing the account's resources. When a GitHub App is suspended, the app's access to the GitHub API or webhook events is blocked for that account. You must use a JWT to access this endpoint.
unsuspend_installation	EXEC	installation_id	Removes a GitHub App installation suspension. You must use a JWT to access this endpoint.