Current section
Files
Jump to
Current section
Files
priv/docs/methods/admin.conversations.disconnectShared.json
{
"args": {
"channel_id": {
"desc": "The channel to be disconnected from some workspaces.",
"example": "C12345",
"required": true
},
"leaving_team_ids": {
"desc": "Used for disconnecting a team from a shared channel. Only one team ID may be passed at a time.",
"required": false,
"type": "array"
}
},
"desc": "Disconnect a connected channel from one or more workspaces.",
"errors": {
"cannot_kick_home_team": "The originating workspace cannot be kicked from the channel.",
"cannot_kick_team": "Only the originating workspace for a connected channel may remove other workspaces from the channel.",
"channel_not_found": "The value passed for `channel_id` was invalid.",
"channel_type_not_supported": "The value passed for `channel_id` was an MPDM, DM, or the 'general' channel.",
"feature_not_enabled": "The token provided does not have access to this method.",
"leaving_team_not_in_channel": "The workspace being removed is not connected to the channel.",
"leaving_team_required": "There are more than two teams in the channel—you must supplied a `leaving_team_id` parameter.",
"no_teams_to_disconnect": "This channel is not shared, so there are no workspaces to disconnect.",
"not_an_admin": "The token provided is not associated with an Org Admin or Owner.",
"not_an_enterprise": "This endpoint can only be called for an Enterprise organization.",
"not_supported": "The passed `channel_id` was a DM, MPDM, or the 'general' channel.",
"restricted_action": "A workspace preference prevents the authenticated user from disconnecting a channel.",
"team_not_found": "At least one of the supplied `leaving_team_ids` are invalid."
},
"rate_limit": {
"label": "Tier 2: 20+ per minute",
"url": "https://docs.slack.dev/apis/web-api/rate-limits"
},
"scopes": {
"user": [
{
"name": "admin.conversations:write",
"url": "https://docs.slack.dev/reference/scopes/admin.conversations.write"
}
]
}
}