POST
/
integrations
/
{integrationType}
/
disconnect
{
  "success": true
}

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