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. Returns the channel's name and already_gone when it was gone before the call, or for the Slack integration the step and its url. Requires connecting a Valet account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"channel": "<channel>"
},
"name": "destroy_channel"
}
}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 | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||