GH_AppInstallation

A GitHub App installed on the organization with specific permissions and repository access

General Information

Represents a GitHub App installed on an organization. App installations have specific permissions and can be scoped to all repositories or a selection of repositories. The permissions granted to the installation are stored as scope:access values such as contents:write in the permissions property.

Unlike fine-grained personal access tokens, GitHub does not expose separate organization and repository permission buckets for app installations, so this property remains a single flat permission list.

Each installation is linked to its parent GH_App via a GH_InstalledAs edge. Installations with repository_selection set to all use one GH_CanAccess edge to the organization’s repository/all GH_Scope; GH_ScopedTo edges enumerate the repositories in that reusable scope. For installations with repository_selection set to selected, the collector uses the enterprise organization-installation repositories API to enumerate the granted repositories when the enterprise installation has Enterprise organization installations: read or Enterprise organization installation repositories: read. If that permission is unavailable, selected repository edges are skipped.

Properties

Property	Type	Description
name	string	The node name used for matching and display.
displayname	string	The human-readable display name.
environmentid	string	The identifier of the GitHub environment where this node was collected.
last_seen	datetime	The timestamp when this node was last observed during collection.
node_id	string	The stable identifier used as the OpenGraph node ID; this is the native GitHub node ID where available.
id	integer	The GitHub installation ID.
app_id	integer	The GitHub App’s numeric ID (shared across all installations of the same app).
app_slug	string	The app’s URL-friendly slug identifier.
description	string	The app’s description.
html_url	string	URL to the app’s GitHub page.
access_tokens_url	string	API URL to create installation access tokens.
repositories_url	string	API URL to list repositories accessible to this installation.
repository_selection	string	Whether the app has access to all repositories or selected repositories.
target_type	string	The target type of the installation (e.g., Organization).
permissions	list[string]	Permissions granted to the installation in scope:access form.
events	string	JSON string of the webhook events the app subscribes to.
created_at	datetime	When the app was installed.
updated_at	datetime	When the installation was last updated.
suspended_at	datetime	When the installation was suspended, if applicable.
environment_name	string	The name of the environment (GitHub organization) where the app is installed.
query_repositories	string	Query for repositories.
query_app	string	Query for app.

Diagram

Edges

The tables below list edges defined by the GitHub extension only. Additional edges to or from this node may be created by other extensions.

Inbound Edges

Edge Type	Source Node Types	Traversable
GH_Contains	GH_Organization	❌
GH_InstalledAs	GH_App	✅

Outbound Edges

Edge Type	Destination Node Types	Traversable
GH_CanAccess	GH_Repository, GH_Scope	❌

Properties

Property	Type	Description
name	str	-
displayname	str	-
environmentid	str	-
last_seen	datetime	-
node_id	str	-
id	int | None	The GitHub installation ID.
app_id	int | None	The GitHub App’s numeric ID (shared across all installations of the same app).
app_slug	str | None	The app’s URL-friendly slug identifier.
description	str | None	The app’s description.
html_url	str | None	URL to the app’s GitHub page.
access_tokens_url	str | None	API URL to create installation access tokens.
repositories_url	str | None	API URL to list repositories accessible to this installation.
repository_selection	str | None	Whether the app has access to all repositories or selected repositories.
target_type	str | None	The target type of the installation (e.g., Organization).
permissions	list[str] | None	Permissions granted to the installation in scope:access form.
events	str | None	JSON string of the webhook events the app subscribes to.
created_at	datetime | None	When the app was installed.
updated_at	datetime | None	When the installation was last updated.
suspended_at	datetime | None	When the installation was suspended, if applicable.
environment_name	str | None	The name of the environment (GitHub organization) where the app is installed.
query_repositories	str | None	Query for repositories.
query_app	str | None	Query for app.