> ## 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.
# Get connector policies
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns the connector policies of the app's workspace, one entry per connector. It tells you whether builders may connect each connector to the workspace's apps, and whether the apps' users may connect their own accounts.
A connector with `builder_connection_enabled` set to `false` can't be connected with [Start connector connection](/api-reference/start-connector-connection). Workspace admins set these policies in the workspace settings. Any editor of the app can read them, including one who isn't a member of the workspace.
The list isn't paginated.
This is limited to 60 requests a minute per caller. Some workspaces have a different limit.
This endpoint accepts a personal API key belonging to a user with editor access to the app, including a read-only key. Workspace API keys are not accepted.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/external-auth/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/apps/{app_id}/external-auth/connector-governance:
get:
summary: Get connector policies
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns the connector policies of the app's workspace, one entry per
connector. It tells you whether builders may connect each connector to
the workspace's apps, and whether the apps' users may connect their own
accounts.
A connector with `builder_connection_enabled` set to `false` can't be
connected with [Start connector
connection](/api-reference/start-connector-connection). Workspace admins
set these policies in the workspace settings. Any editor of the app can
read them, including one who isn't a member of the workspace.
The list isn't paginated.
This is limited to 60 requests a minute per caller. Some workspaces have
a different limit.
This endpoint accepts a personal API key belonging to a user with
editor access to the app, including a read-only key. Workspace API keys
are not accepted.
operationId: >-
list_app_connector_governance_api_apps__app_id__external_auth_connector_governance_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app.
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
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 don't have editor access to this app, or you used a workspace
API key.
'404':
description: App not found.
'409':
description: The app's workspace requires an unlocked SSO session.
'429':
description: Rate limit reached. Retry later.
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
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 `.'
````