Disconnect a channel
Removes a channel; its waiting posts are deleted, and refunded when their time had not come.
Free
This tool costs nothing to call.
An example
We stopped using our Mastodon account. Disconnect it.
Your agent callssocial_disconnectFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"channel_id": "clx0d6k2v0004"
}Use it when
The business stops using a social account here.
What it does
Remove a channel from the business's social workspace. Its waiting posts are deleted with it: the ones whose time hadn't come are refunded, posts that went out stay on the network. Free.
What comes back
disconnected: the channel_id. Its waiting posts are deleted with it. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
channel_idRequired | string | A channel_id from social_channels. 1 to 64 characters, matches ^[A-Za-z0-9_-]+$. |
The call
Over MCP, call social_disconnect on https://api.conecto.chat/mcp/social. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/social_disconnect \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"channel_id":"clx0d6k2v0004"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No channel of the business has that channel_id. | Call social_channels and use one of its channel_ids. |
no_channels409 | The business has no connected channel yet. | Connect one with social_connect. |
not_switched_on503 | Social posting is not switched on yet. | Try again later; nothing was charged. |
social_unavailable503 | The posting service did not answer, or could not open the business's social workspace. | Call again in a minute; when the message says so, tell Conecto's support. |
refused400 | The posting service refused the request; the message gives its reason. | Fix what the reason names, then call again. |
refused422 | The posting service reported a conflict with what is there. | Read the channel or post again, then call again. |
rate_limited429 | The posting service's limit of posts an hour was reached. | Try again later. |
More Social tools
All 13 tools- List the social networks
social_networksEvery network the business can post to, how each connects (a link, a login, Telegram's code, or its own bot or webhook), and whether it is switched on yet.Free* - Connect a social account
social_connectConnects one of the business's own social accounts as a channel: by a link for the owner, a login, or a code posted in a Telegram channel.Free - List the connected channels
social_channelsThe business's connected social accounts (channels), with their network, name and profile.Free* - Read a channel's rules
social_channel_rulesWhat a channel's network accepts: lengths, media counts, the settings a post needs, and its lookups.Free* - Look something up on a channel
social_channel_lookupRuns one of a channel's lookups, like the channels of a Discord server or the boards on Pinterest.Free* - Find a free time to post
social_find_slotThe next free time to post on a channel, from its posting times and what is already scheduled.Free* - Post to social channels
social_postPosts now or at a set time to one or several channels, with pictures, video or a thread.$0.02 per channel posted to - Read a post waiting for its owner
social_post_checkReads a TikTok post waiting for its owner, with what to show and ask them from TikTok just now.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md