> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# List workspace GitHub installations

> <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](/api-reference/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>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/github/workspace-installations
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/github/workspace-installations:
    get:
      summary: List workspace GitHub installations
      description: >-
        <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](/api-reference/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>
      operationId: >-
        get_app_workspace_installations_api_apps__app_id__github_workspace_installations_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the app whose workspace decides which GitHub organizations
              you can use.
            title: App Id
          description: >-
            ID of the app whose workspace decides which GitHub organizations you
            can use.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: The workspace's GitHub installations you can use.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GitHubWorkspaceInstallations'
        '401':
          description: Missing or invalid credentials.
        '402':
          description: Your workspace plan doesn't include the GitHub integration.
        '403':
          description: >-
            You don't have access to this app, or you used a workspace API key.
            These endpoints take a personal API key.
        '404':
          description: App not found.
        '429':
          description: >-
            Rate limit exceeded. The base limit is 30 requests per minute. See
            [Rate
            limits](/developers/references/apps-api/get-started/rate-limits) for
            the multiplier your plan gets.
components:
  schemas:
    GitHubWorkspaceInstallations:
      items:
        $ref: '#/components/schemas/GitHubWorkspaceInstallation'
      type: array
      title: GitHubWorkspaceInstallations
      description: The workspace's GitHub installations you can use.
    GitHubWorkspaceInstallation:
      properties:
        id:
          type: string
          title: Id
          description: >-
            ID of the installation in Base44. Pass it as
            `workspace_installation_id` to [Connect a GitHub
            repository](/api-reference/connect-a-github-repository).
          example: 66f1c2d9a4b7e80012ab34cd
        github_installation_id:
          type: string
          title: Github Installation Id
          description: ID of the Base44 GitHub App installation on GitHub.
          example: '58231904'
        account_login:
          type: string
          title: Account Login
          description: GitHub organization the installation is on.
          example: acme-inc
        account_avatar_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Avatar Url
          description: >-
            URL of the organization's GitHub avatar, or `null` when GitHub
            didn't return one.
          example: https://avatars.githubusercontent.com/u/1234567?v=4
        repository_selection:
          type: string
          enum:
            - all
            - selected
          title: Repository Selection
          description: >-
            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: all
      type: object
      required:
        - id
        - github_installation_id
        - account_login
        - repository_selection
      title: GitHubWorkspaceInstallation
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.