GitHub App installations API reference

You can create a GitHub App installation using the HCP Terraform UI. Learn how to create a GitHub App installation.

Note: To use this resource in Terraform Enterprise installations, you must configure the GitHub App in the site admin area.

Note: You can only use this API if you have already authorized the Terraform Cloud GitHub App. Manage your GitHub App token from Account Settings > Tokens.

List Installations

This endpoint lists GitHub App installations available to the current user.

GET /github-app/installations

Query Parameters

Queries only return GitHub App Installations that the current user has access to within GitHub.

Parameter	Description
`filter[name]`	Optional. If present, returns a list of available GitHub App installations that match the GitHub organization or login.
`filter[installation_id]`	Optional. If present, returns a list of available GitHub App installations that match the installation ID within GitHub. (Not HCP Terraform)

Sample Request

$ curl \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  https://app.terraform.io/api/v2/github-app/installations

Sample Response

{
    "data": [
        {
            "id": "ghain-BYrbNeGQ8nAzKouu",
            "type": "github-app-installations",
            "attributes": {
                "name": "octouser",
                "installation-id": 54810170,
                "icon-url": "https://avatars.githubusercontent.com/u/29916665?v=4",
                "installation-type": "User",
                "installation-url": "https://github.com/settings/installations/54810170"
            }
        }
    ]
}

Show Installation

GET /github-app/installation/:gh_app_installation_id

Parameter	Description
`:gh_app_installation_id`	The Github App Installation ID

Sample Request

$ curl \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  https://app.terraform.io/api/v2/github-app/installation/ghain-R4xmKTaxnhLFioUq

Sample Response

{
    "data": {
        "id": "ghain-R4xmKTaxnhLFioUq",
        "type": "github-app-installations",
        "attributes": {
            "name": "octouser",
            "installation-id": 54810170,
            "icon-url": "https://avatars.githubusercontent.com/u/29916665?v=4",
            "installation-type": "User",
            "installation-url": "https://github.com/settings/installations/54810170"
        }
    }
}