> ## 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.
# Disconnect connector
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Disconnects a connector from the app and stops the app from using the connected account.
When the connection belongs to the app, its stored tokens are deleted. When it's a workspace connection shared with other apps, only this app is detached, and the others keep using it. Either way, the app's backend functions and agents can no longer use the connector, and any events the provider sends for it stop reaching the app.
How the two compare:
- [Disconnect connector](/api-reference/disconnect-connector) keeps the connector on the app, marked `disconnected` with its scopes, so it can be connected again with the same scopes.
- [Remove connector](/api-reference/remove-connector) deletes it from the app, including its entry in the app's code.
The call succeeds even when the app has no connection for the connector.
This is limited to 10 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. A read-only key is refused, and workspace API keys are not accepted.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/external-auth/integrations/{integration_type}
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/integrations/{integration_type}:
delete:
summary: Disconnect connector
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Disconnects a connector from the app and stops the app from using the
connected account.
When the connection belongs to the app, its stored tokens are deleted.
When it's a workspace connection shared with other apps, only this app
is detached, and the others keep using it. Either way, the app's backend
functions and agents can no longer use the connector, and any events the
provider sends for it stop reaching the app.
How the two compare:
- [Disconnect connector](/api-reference/disconnect-connector) keeps the
connector on the app, marked `disconnected` with its scopes, so it can
be connected again with the same scopes.
- [Remove connector](/api-reference/remove-connector) deletes it from
the app, including its entry in the app's code.
The call succeeds even when the app has no connection for the connector.
This is limited to 10 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. A read-only key is refused, and workspace API
keys are not accepted.
operationId: >-
disconnect_integration_api_apps__app_id__external_auth_integrations__integration_type__delete
parameters:
- name: integration_type
in: path
required: true
schema:
anyOf:
- type: string
enum:
- googlecalendar
- google_classroom
- googledrive
- gmail
- googlesheets
- googledocs
- googleslides
- googlebigquery
- googlemeet
- googletasks
- googleads
- google_analytics
- google_search_console
- slack
- notion
- salesforce
- hubspot
- linkedin
- tiktok
- instagram
- discord
- slackbot
- wix
- github
- gitlab
- bamboohr
- dropbox
- clickup
- wrike
- box
- outlook
- linear
- airtable
- microsoft_teams
- share_point
- one_drive
- typeform
- splitwise
- hugging_face
- calendly
- contentful
- supabase
- snowflake
- databricks
- quickbooks
- square
- type: string
maxLength: 80
minLength: 1
pattern: ^[a-z0-9_]+$
description: >-
ID of the connector, from `integration_type` in [List
connectors](/api-reference/list-connectors).
title: Integration Type
description: >-
ID of the connector, from `integration_type` in [List
connectors](/api-reference/list-connectors).
example: googlecalendar
- 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 connector is disconnected from the app.
content:
application/json:
schema:
$ref: '#/components/schemas/DisconnectIntegrationResult'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have editor access to this app, you're a viewer in its
workspace, your API key is read-only, or you used a workspace API
key.
'404':
description: >-
App not found, or the connector isn't available to you and the app
has no connection for it.
'409':
description: The app's workspace requires an unlocked SSO session.
'422':
description: '`integration_type` isn''t a valid connector ID.'
'429':
description: Rate limit reached. Retry later.
components:
schemas:
DisconnectIntegrationResult:
properties:
status:
type: string
const: disconnected
title: Status
description: Always `disconnected`.
example: disconnected
integration_type:
type: string
title: Integration Type
description: Connector that was disconnected.
example: googlecalendar
type: object
required:
- status
- integration_type
title: DisconnectIntegrationResult
description: Confirmation that the connector is disconnected from the app.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````