> ## 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.

# 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 an app to GitHub](/api-reference/connect-an-app-to-github).

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 an app to
        GitHub](/api-reference/connect-an-app-to-github).


        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. The code is
            `git_sync_not_supported` when the app's type doesn't support Git
            sync.
        '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.
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - full_access
        - WorkspaceApiKeyAuth:
            - full_access
        - WorkspaceApiKeyBearerAuth:
            - full_access
components:
  schemas:
    GitHubWorkspaceInstallations:
      items:
        $ref: '#/components/schemas/GitHubWorkspaceInstallation'
      type: array
      title: GitHubWorkspaceInstallations
      description: The workspace's GitHub installations you can use.
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    GitHubWorkspaceInstallation:
      properties:
        id:
          type: string
          title: Id
          description: >-
            ID of the installation in Base44. Pass it as
            `workspace_installation_id` to [Connect an app to
            GitHub](/api-reference/connect-an-app-to-github).
          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
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

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