> ## 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 connectors > This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Returns every connector set up in a workspace, with its OAuth client ID and scopes. The client secret is never returned. A workspace connector holds the workspace's own OAuth app for a connector, so the workspace's apps connect through it instead of through Base44's OAuth app. A connector can also run on Base44's OAuth app for the apps' users, when `credential_source` is `base44`. 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. 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. ## OpenAPI ````yaml /developers/references/app-management/app-management-openapi.json get /api/workspace/{workspace_id}/connectors 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}/connectors: get: summary: List workspace connectors description: >- This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Returns every connector set up in a workspace, with its OAuth client ID and scopes. The client secret is never returned. A workspace connector holds the workspace's own OAuth app for a connector, so the workspace's apps connect through it instead of through Base44's OAuth app. A connector can also run on Base44's OAuth app for the apps' users, when `credential_source` is `base44`. 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. 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. operationId: list_connectors_api_workspace__workspace_id__connectors_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 connectors. content: application/json: schema: $ref: '#/components/schemas/OrganizationConnectorListResponse' '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: OrganizationConnectorListResponse: properties: items: items: $ref: '#/components/schemas/OrganizationConnectorResponse' type: array title: Items description: Every connector in the workspace. example: - client_id: 1234567890-abc123def456.apps.googleusercontent.com connection_config: {} credential_source: byo id: 6820f3a4e7b91d003c45a1f9 integration_type: googlecalendar name: Sales Google Calendar organization_id: 67e0b12c4d8a3f005b21c9e4 scopes: - https://www.googleapis.com/auth/calendar.readonly uses_oauth_gateway: true total: type: integer title: Total description: Number of connectors in `items`. example: 1 gateway_redirect_uri: anyOf: - type: string - type: 'null' title: Gateway Redirect Uri description: >- Single redirect URI to register for connectors with `uses_oauth_gateway` set to `true`. Left out when the gateway callback isn't available to you. example: https://connectors.base44.com/api/oauth/callback type: object required: - items - total title: OrganizationConnectorListResponse description: The workspace's connectors. OrganizationConnectorResponse: properties: id: type: string title: Id description: >- ID of the workspace connector. Pass it as `connector_id` to [Start connector connection](/api-reference/start-connector-connection). example: 6820f3a4e7b91d003c45a1f9 organization_id: type: string title: Organization Id description: ID of the workspace. example: 67e0b12c4d8a3f005b21c9e4 integration_type: type: string title: Integration Type description: Connector it's for. example: googlecalendar name: type: string title: Name description: Name of the workspace connector. example: Sales Google Calendar credential_source: type: string enum: - byo - base44 description: >- Whose OAuth app it runs on: `byo` for the workspace's own, or `base44` for Base44's. default: byo example: byo client_id: type: string title: Client Id description: >- Client ID of the workspace's OAuth app. Empty for a connector on Base44's OAuth app. example: 1234567890-abc123def456.apps.googleusercontent.com scopes: items: type: string type: array title: Scopes description: OAuth scopes connections through it ask for. example: - https://www.googleapis.com/auth/calendar.readonly connection_config: additionalProperties: type: string type: object title: Connection Config description: >- Connection values saved on it, keyed by field name. Empty when the connector needs none. example: {} uses_oauth_gateway: type: boolean title: Uses Oauth Gateway description: >- Whether new connections return to the single gateway redirect URI (`true`) or to the per-app ones (`false`). [Get OAuth redirect URIs](/api-reference/get-oauth-redirect-uris) says which to register. default: false example: true type: object required: - id - organization_id - integration_type - name - client_id - scopes title: OrganizationConnectorResponse description: A workspace connector. The client secret is never returned. securitySchemes: PersonalAccessTokenAuth: type: http scheme: bearer description: 'Personal access token, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.