Get workspace connector policies

curl --request GET \
  --url https://app.base44.com/api/workspace/{workspace_id}/connector-governance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/workspace/{workspace_id}/connector-governance"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/workspace/{workspace_id}/connector-governance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/workspace/{workspace_id}/connector-governance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/workspace/{workspace_id}/connector-governance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/workspace/{workspace_id}/connector-governance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "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": false
}

Connector governance

Get workspace 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 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. In FERPA-designated workspaces, OAuth connectors start with both switches off. Only an active workspace owner or admin can enable them; workspace credentials alone do not count as approval. Connector policies are available on every plan for those workspaces. 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.

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.

GET

api

workspace

{workspace_id}

connector-governance

Get workspace connector policies

curl --request GET \
  --url https://app.base44.com/api/workspace/{workspace_id}/connector-governance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/workspace/{workspace_id}/connector-governance"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/workspace/{workspace_id}/connector-governance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/workspace/{workspace_id}/connector-governance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/workspace/{workspace_id}/connector-governance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/workspace/{workspace_id}/connector-governance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "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": false
}

Authorizations

Authorization

string

header

required

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.

Path Parameters

workspace_id

string

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 connector policies.

The workspace's connector policies, as they apply to the app.

items

ConnectorGovernanceItem · object[]

required

One entry per connector available to the workspace.

Show child attributes

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

boolean

required

Whether the workspace has restricted any connector (true) or left them all at the defaults (false).

Example:

false

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Get workspace connector policies

Authorizations

Path Parameters

Response