List workspace GitHub installations

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Lists the GitHub organizations connected to the app's workspace that you can create the app's repository in. Pass an installation's id as workspace_installation_id to Connect a GitHub repository.

Only active installations on GitHub organizations appear, and only those the workspace allows for new apps. Organizations are connected to the workspace in its settings rather than through this API. Calling this re-checks repository_selection with GitHub for installations set to selected.

This endpoint is limited to 30 requests per minute. Some workspaces have a different limit.

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/apps/{app_id}/github/workspace-installations

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/github/workspace-installations
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app whose workspace decides which GitHub organizations you can use.

Response

The workspace's GitHub installations you can use.

idstring required

ID of the installation in Base44. Pass it as workspace_installation_id to Connect a GitHub repository.

github_installation_idstring required

ID of the Base44 GitHub App installation on GitHub.

account_loginstring required

GitHub organization the installation is on.

account_avatar_urlstring nullable

URL of the organization's GitHub avatar, or null when GitHub didn't return one.

repository_selection'all' | 'selected' required

Whether the Base44 GitHub App can reach all of the organization's repositories (all) or only chosen ones (selected). You can't create a repository through an installation set to selected, so switch it to all repositories in GitHub first.

Example response

[
  {
    "id": "66f1c2d9a4b7e80012ab34cd",
    "github_installation_id": "58231904",
    "account_login": "acme-inc",
    "account_avatar_url": "https://avatars.githubusercontent.com/u/1234567?v=4",
    "repository_selection": "all"
  }
]

Changes