Destroy a channel
destroy_channelDestroy a channel and its routes. This cannot be undone, so confirm with the user first. Without name, it destroys an organization channel found with list_channels; an organization channel that any agent still holds is refused, and the answer names each holder: free each with detach_channel, then destroy it. With name, it destroys a channel that agent owns, such as one create_channel made; a channel the agent only holds from the organization is detached with detach_channel instead. A channel found only in the other scope is refused with the call to make. A channel on an app is destroyed the same way, naming the app in name. Destroying a channel that is already gone changes nothing. The organization's Slack integration removes every agent's Slack app, so for it this gives the step to take and destroys nothing. Requires connecting a Valet account.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The owning agent's or app's name, for a channel it owns. Omit to destroy an organization channel. | |
| channel | Yes | Required. The channel's name, from list_channels. | |
| org_name | No | The Valet organization the channel belongs to. Omit to use the organization the account joined first. |