git.github.list-installationsList connected GitHub accounts and the repositories each covers
Request syntax
GET /git/api/github/installationsResponse
200 with `app` (the platform's GitHub App, null while it is not registered) and `installations`: each with its account, whether it is suspended, the repositories it covers and which of them are mirrored here already. An installation GitHub would not list answers with `error` set and no repositories, not a failed request.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
appAlwaysobject, may be null
The platform's GitHub App; null while it is not registered, and then `installations` is emptyapp.slugAlwaysstring
The App's slug on GitHub (github.com/apps/{slug})app.nameAlwaysstring
The App's nameapp.hostAlwaysstring
The GitHub host it is registered on (github.com)installationsAlwaysarray of object
The organization's connected installations, by account nameinstallations[].idAlwaysstring
The installation here: the `{id}` of the other github operationsinstallations[].installationIdAlwaysnumber
GitHub's id of the installationinstallations[].accountAlwaysstring
The GitHub user or organization it is installed oninstallations[].accountTypeAlwaysstring
User or Organization, as GitHub saysinstallations[].repositorySelectionAlwaysone of all, selected
Whether it covers all of the account’s repositories or a chosen fewinstallations[].suspendedAlwaysboolean
Suspended on GitHub; nothing is listed or mirrored through itinstallations[].errorAlwaysstring, may be null
Why its repositories could not be listed (suspended, GitHub's answer); null when they wereinstallations[].repositoriesAlwaysarray of object
The repositories the installation covers now; empty when `error` is setinstallations[].repositories[].fullNameAlwaysstring
owner/name on GitHubinstallations[].repositories[].privateAlwaysboolean
Private on GitHubinstallations[].repositories[].archivedAlwaysboolean
Archived on GitHubinstallations[].repositories[].defaultBranchAlwaysstring, may be null
Its default branch; null when GitHub did not sayinstallations[].repositories[].htmlUrlAlwaysstring
Its page on GitHubinstallations[].repositories[].mirroredAsAlwaysobject, may be null
The repository here that mirrors it; null when none doesinstallations[].repositories[].mirroredAs.idAlwaysstring
The mirror repository hereinstallations[].repositories[].mirroredAs.nameAlwaysstring
Its name hereinstallations[].repositories[].mirroredAs.shadowCiAlwaysboolean
Shadow CI is on for itinstallations[].repositories[].mirroredAs.shadowPausedAlwaysstring, may be null
Why shadow CI is paused (a cap reached); null when it is not
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow git:ListGithubInstallations on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud git github list-installationscurl -X GET "https://console.platform-development.deutschecloud.app/git/api/github/installations" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_github_list-installations.