Skip to main content
POST
/
integrations
/
{integrationType}
/
disconnect
Disconnect Integration
curl --request POST \
  --url https://api.example.com/integrations/{integrationType}/disconnect \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalUserIdentifier": "<string>"
}
'
{
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.suada.ai/llms.txt

Use this file to discover all available pages before exploring further.

Disconnect and disable a third-party integration for a specific user.

​
URL Parameters

​
integrationType
string
required
The type of integration to disconnect. Valid values:
  • google-analytics
  • notion
  • slack
  • zoho
  • gmail

​
Request

​
externalUserIdentifier
string
required
Unique identifier for the user in your system

​
Response

​
success
boolean
Whether the disconnection was successful

​
Example

curl -X POST https://suada.ai/api/public/integrations/notion/disconnect \
  -H "Authorization: Bearer sk-suada-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserIdentifier": "user-123"
  }'

{
  "success": true
}

​
Error Codes

​
400
object
Invalid request
{
  "error": "Missing required parameters"
}
​
401
object
Authentication error
{
  "error": "Invalid or expired API key"
}
​
404
object
Integration not found
{
  "error": "Integration not found"
}
​
500
object
Server error
{
  "error": "Failed to disconnect integration"
}

​
Notes

  • This endpoint disables the integration but preserves its configuration
  • The integration can be re-enabled by going through the connection flow again
  • Any ongoing data synchronization will be stopped
  • Access tokens and other credentials are revoked
  • The integration’s status will be updated to reflect the disconnection