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

# Get workspace connector policies

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

Returns the connector policies of a workspace, one entry per connector available to it.

A connector policy has two switches. `builder_connection_enabled` decides whether builders can connect the connector to the workspace's apps. `per_user_connection_enabled` decides whether the apps' users can connect their own accounts through a workspace connector. [Get connector policies](/api-reference/get-connector-policies) returns the same list for an app's workspace.

The list isn't paginated.

This is limited to 120 requests per minute. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as any member of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token works. Workspace API keys aren't accepted.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/workspace/{workspace_id}/connector-governance
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/workspace/{workspace_id}/connector-governance:
    get:
      summary: Get workspace connector policies
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns the connector policies of a workspace, one entry per connector
        available to it.


        A connector policy has two switches. `builder_connection_enabled`
        decides whether builders can connect the connector to the workspace's
        apps. `per_user_connection_enabled` decides whether the apps' users can
        connect their own accounts through a workspace connector. [Get connector
        policies](/api-reference/get-connector-policies) returns the same list
        for an app's workspace.


        The list isn't paginated.


        This is limited to 120 requests per minute. A signed-in session has its
        own limit, and every personal access token for the workspace shares one.
        Some workspaces have a different limit.


        <Note>Call this as any member of the workspace, with a personal access
        token for that workspace sent as a Bearer token, or from a signed-in
        session. A read-only token works. Workspace API keys aren't
        accepted.</Note>
      operationId: >-
        list_connector_governance_api_workspace__workspace_id__connector_governance_get
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the workspace. With a personal access token, use the token's
              workspace. Get it from `organization_id` in [Get
              app](/api-reference/get-app).
            title: Workspace Id
          description: >-
            ID of the workspace. With a personal access token, use the token's
            workspace. Get it from `organization_id` in [Get
            app](/api-reference/get-app).
          example: 67e0b12c4d8a3f005b21c9e4
      responses:
        '200':
          description: The workspace's connector policies.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorGovernanceListResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't a member of the workspace, your token is for a different
            workspace, or your credential can't be used on this endpoint.
        '409':
          description: The workspace requires an unlocked SSO session.
        '429':
          description: Rate limit exceeded.
components:
  schemas:
    ConnectorGovernanceListResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ConnectorGovernanceItem'
          type: array
          title: Items
          description: One entry per connector available to the workspace.
          example:
            - builder_connection_enabled: true
              connector_mode: all
              display_name: Google Calendar
              has_per_user_credentials: false
              integration_type: googlecalendar
              per_user_connection_enabled: false
        has_any_governance_policies:
          type: boolean
          title: Has Any Governance Policies
          description: >-
            Whether the workspace has restricted any connector (`true`) or left
            them all at the defaults (`false`).
          example: false
      type: object
      required:
        - items
        - has_any_governance_policies
      title: ConnectorGovernanceListResponse
      description: The workspace's connector policies, as they apply to the app.
    ConnectorGovernanceItem:
      properties:
        integration_type:
          type: string
          title: Integration Type
          description: ID of the connector.
          example: googlecalendar
        display_name:
          type: string
          title: Display Name
          description: Name of the connector.
          example: Google Calendar
        connector_mode:
          type: string
          title: Connector Mode
          description: >-
            Which ways the connector can be connected. One of `all`,
            `shared_only`, `app_user_only`, `byo_shared_only`, or
            `byo_shared_and_app_user`, with the same meaning as `connector_mode`
            in [List connectors](/api-reference/list-connectors).
          example: all
        builder_connection_enabled:
          type: boolean
          title: Builder Connection Enabled
          description: >-
            Whether the workspace lets builders connect the connector to its
            apps (`true`) or has turned that off (`false`). When it's `false`,
            starting a connection is refused.
          example: true
        per_user_connection_enabled:
          type: boolean
          title: Per User Connection Enabled
          description: >-
            Whether the apps' users can connect their own accounts with the
            workspace's credentials (`true`) or not (`false`). Always `false`
            when `has_per_user_credentials` is `false`.
          example: false
        has_per_user_credentials:
          type: boolean
          title: Has Per User Credentials
          description: >-
            Whether the workspace has set up its own OAuth app credentials for
            the connector.
          example: false
        not_yet_enabled:
          type: boolean
          title: Not Yet Enabled
          description: >-
            Whether both switches are off only because the connector became
            available after the workspace chose to start new connectors off, and
            nobody has set its policy yet (`true`). Setting either switch makes
            it `false`.
          default: false
          example: false
      type: object
      required:
        - integration_type
        - display_name
        - connector_mode
        - builder_connection_enabled
        - per_user_connection_enabled
        - has_per_user_credentials
      title: ConnectorGovernanceItem
  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.