Skip to main content
PUT
Update workspace connector

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

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.

connector_id
string
required

ID of the workspace connector to update, from id in List workspace connectors.

Body

application/json

The workspace connector fields to change. Leave out the ones to keep.

name
string | null

New name. Must be unique in the workspace, matching case exactly.

Minimum string length: 1
Example:

"Sales Google Calendar"

credential_source
enum<string> | null

Send base44 to move a connector from your own OAuth app onto Base44's. It can't move back. Moving drops the stored client ID and secret, and app users who connected through your OAuth app have to connect again.

Available options:
byo,
base44
Example:

"base44"

client_id
string | null

New client ID of your OAuth app. Not accepted for a connector on Base44's OAuth app.

Required string length: 1 - 512
Example:

"1234567890-abc123def456.apps.googleusercontent.com"

client_secret
string | null

New client secret of your OAuth app, to rotate it. Not accepted for a connector on Base44's OAuth app. It's stored encrypted and never returned.

Required string length: 1 - 512
Example:

"your-new-oauth-client-secret"

scopes
string[] | null

New list of OAuth scopes, replacing the current one.

Example:
connection_config
Connection Config · object | null

New connection values, replacing the current ones.

Example:
uses_oauth_gateway
boolean | null

Whether new connections return to the single gateway redirect URI (true) or to the per-app ones (false). Register the matching URIs in the provider's console first, from Get OAuth redirect URIs. Not accepted for a connector on Base44's OAuth app, which always uses the gateway.

Example:

true

Response

The updated workspace connector.

A workspace connector. The client secret is never returned.

id
string
required

ID of the workspace connector. Pass it as connector_id to Start connector connection.

Example:

"6820f3a4e7b91d003c45a1f9"

organization_id
string
required

ID of the workspace.

Example:

"67e0b12c4d8a3f005b21c9e4"

integration_type
string
required

Connector it's for.

Example:

"googlecalendar"

name
string
required

Name of the workspace connector.

Example:

"Sales Google Calendar"

client_id
string
required

Client ID of the workspace's OAuth app. Empty for a connector on Base44's OAuth app.

Example:

"1234567890-abc123def456.apps.googleusercontent.com"

scopes
string[]
required

OAuth scopes connections through it ask for.

Example:
credential_source
enum<string>
default:byo

Whose OAuth app it runs on: byo for the workspace's own, or base44 for Base44's.

Available options:
byo,
base44
Example:

"byo"

connection_config
Connection Config · object

Connection values saved on it, keyed by field name. Empty when the connector needs none.

Example:
uses_oauth_gateway
boolean
default:false

Whether new connections return to the single gateway redirect URI (true) or to the per-app ones (false). Get OAuth redirect URIs says which to register.

Example:

true