List workspace connectors

Changed on

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

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.

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

get/api/workspace/{workspace_id}/connectors

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/workspace/{workspace_id}/connectors
  • Auth: HTTP bearer

Path parameters

workspace_idstring required

ID of the workspace. With a personal access token, use the token's workspace. Get it from organization_id in Get app.

Response

The workspace's connectors.

totalinteger required

Number of connectors in items.

gateway_redirect_uristring nullable

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 response

{
  "items": [
    {
      "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": 1,
  "gateway_redirect_uri": "https://connectors.base44.com/api/oauth/callback"
}

Changes