Sign in

List GitHub organizations

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

Lists the GitHub accounts you can create the app's repository in: your personal account first, then your organizations alphabetically.

Only accounts with the Base44 GitHub App installed appear, so install it on the account you want before you call this. Your own GitHub account also has to be connected to Base44, which happens in the builder and is not part of this API.

When the app's workspace limits GitHub repositories to approved organizations, this returns only the approved ones. That filtering applies to workspace admins too, so a missing organization does not mean you can't use it. Call Get GitHub organization policy to see whether the limit is on.

Read repository_selection before you connect. An account set to selected rejects a new repository until its installation covers all repositories.

Pass an account's login and installation_id to Connect a GitHub repository.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

get/api/apps/{app_id}/github/organizations

Path parameters

app_idstring required

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

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

Response

The GitHub accounts you can create the app's repository in.

idinteger required

GitHub's numeric ID for the account.

loginstring required

GitHub username or organization name. Pass it as org_name to Connect a GitHub repository.

avatar_urlstring required

URL of the account's GitHub profile picture.

installation_idstring required

ID of the Base44 GitHub App installation on this account. Pass it as installation_id to Connect a GitHub repository.

type'User' | 'Organization' required

User for your personal account, Organization for an organization.

repository_selection'all' | 'selected'

Which repositories the Base44 GitHub App can reach on this account. selected means it is installed on specific repositories only, so creating a new repository under this account fails until you switch the installation to all repositories.

Example response

[
  {
    "id": 1024547,
    "login": "base44",
    "avatar_url": "https://avatars.githubusercontent.com/u/1024547?v=4",
    "installation_id": "58231904",
    "type": "Organization",
    "repository_selection": "all"
  }
]

Changes