Connections
Remove a connection
Forgets a connected system and its credential; the system itself doesn't change.
Free
This tool costs nothing to call.
An example
We are done with the old help desk. Remove its connection.
Your agent callsconnect_removeFree
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
With these arguments
{
"connection": "zendesk"
}What comes back
Use it when
The company stops using a system, or the agent shouldn't reach it any more.
What it does
Forget a connected system and its credential. Nothing changes in the system itself.
What comes back
removed: the connection's name. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
connectionRequired | string | The connection's name. 2 to 40 characters. |
The call
Over MCP, call connect_remove on https://api.conecto.chat/mcp/connect. Over REST:
Terminal
curl -X POST https://api.conecto.chat/v1/tools/connect_remove \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"connection":"zendesk"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No connection has that name. | connect_list shows them. |
More Connections tools
All 6 tools- Connect a system
connect_addConnects one of the company's systems: its address, its credential (kept encrypted) and the calls it may make.Free - List connected systems
connect_listThe connected systems with their address, auth and allowed calls, and this month's call count.Free* - Preview a call to a connected system
connect_previewShows exactly what a call would send (method, full address, headers with the credential hidden, body) without sending it.Free* - Call a connected system
connect_callSends one request to a connected system, inside its allowed calls, and returns its answer.$0.0003 when it answers within 10 seconds - Change a system's allowed calls
connect_set_rulesReplaces a connection's allowed calls; waits for the owner's approval by default.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md