Sign in
Hosting: Git

List Git installations

Lists the Git provider accounts the customer has connected. Only installations with status active are returned unless the status filter says otherwise.

An empty list means the customer has no active installation. Check status=suspended and status=pending as well. If there is none at all, a Git provider (GitHub or GitLab) has to be connected once in hPanel (Websites, Manage, Advanced, Git; or Add Website, Node.js Web App, Import Git Repository); this endpoint then lists the new installation.

Use uuid as the path parameter of List Git installation repositories, and as installation_uuid in Start Node.js build with source_type git and in Update Git auto-deployment settings.

get/api/hosting/v1/git/installations

Query parameters

provider'github' | 'gitlab' | 'bitbucket' nullable
Example:github

Filter by Git provider

status'pending' | 'active' | 'suspended'
Example:active

Filter by installation status

Response

Success response

uuidstring required

Installation identifier. Use it as the path parameter of List Git installation repositories.

provider'github' | 'gitlab' | 'bitbucket' required

Git provider the account belongs to

account_loginstring nullable required

Login of the connected provider account (user or organization)

account_type'User' | 'Organization' nullable required

Whether the connected account is a user or an organization

account_avatar_urlstring nullable required

Avatar URL of the connected provider account

status'pending' | 'active' | 'suspended' required

Installation status. Only active installations are listed unless the status filter says otherwise.

installed_atstring date-time nullable required

When the provider app was installed on the account

created_atstring date-time required

When the installation record was created

has_oauthboolean nullable required

True when the GitHub user account has a stored OAuth token whose refresh token is still valid, false when the token is missing or its refresh token expired. Null for organization accounts and for providers other than GitHub.

Example response

[
  {
    "uuid": "018f5e2a-1234-7890-abcd-1234567890ab",
    "provider": "github",
    "account_login": "octocat",
    "account_type": "User",
    "account_avatar_url": "https://avatars.githubusercontent.com/u/583231",
    "status": "active",
    "installed_at": "2026-01-15T10:30:00Z",
    "created_at": "2026-01-15T10:00:00Z",
    "has_oauth": true
  }
]

Changes

Changed in 1 of the 118 revisions of this API.1