Skip to main content

team.externalTeams.disconnect method

Welcome to the new home of Slack developer docs!

We're still building and not all features are available quite yet. Enjoy this peek into the future!

Not ready for the future? Return to the past at api.slack.com.

Usage info​

This method disconnects Slack Connect channels and direct messages (DMs) from an organization to end all communication with them. Disconnecting from an organization ends all communication, but depending on permissions, still allows access to conversation history. Refer to this help center article for the expected behavior of disconnecting a channel, MPDM, or DM.

Example request:

{
  "target_team": "T123ABCDEF"
}

Note that the disconnect process occurs in the background and may take some time to complete.

Use cases​

This method may be useful for:

  • Automating compliance—automatically disconnect from organizations that no longer meet your compliance or security standards.

  • Streamlining management—integrate disconnection into on-boarding/off-boarding processes for seamless management of external collaborations.

  • Routine maintenance—schedule regular audits and disconnections as part of your organization's routine maintenance tasks.

Response​