Sample - Slack Web API
POST/admin.conversations.restrictAccess.removeGroup

Remove an identity-provider group from a channel

Removes an identity-provider group from a private channel's allowlist. Supply team_id, group_id, and channel_id in the form-encoded request body to identify the workspace, group, and channel. Use a token with the administrative write scope.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 body fields

Form-encoded details for removing a linked identity-provider group from a private channel.

tokenstringrequired
Authentication token. Requires scope: `admin.conversations:write`
team_idstringrequired
The workspace where the channel exists. This argument is required for channels only tied to one workspace, and optional for channels that are shared across an organization.
group_idstringrequired
The [IDP Group](https://slack.com/help/articles/115001435788-Connect-identity-provider-groups-to-your-Enterprise-Grid-org) ID to remove from the private channel.
channel_idstringrequired
The channel to remove the linked group from.

2 status codes
200Returns a successful response containing the `ok` flag after unlinking the identity-provider group.
okbooleanrequired
Allowed:true
defaultReturned when the group cannot be removed successfully; the response contains `ok: false`.
okbooleanrequired
Allowed:false

Error handling

token must provide the admin.conversations:write scope. The body must include team_id, group_id, and channel_id, and each value must identify the workspace, group, and private channel involved.