Connections

Change a system's allowed calls

connect_set_rules · Changes data · Markdown

Replaces a connection's allowed calls; waits for the owner's approval by default.

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

An example

Let yourself also add comments to tickets in the old help desk.

Your agent callsconnect_set_rules$0.001 a call

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",
  "allow": [
    "GET /tickets*",
    "PUT /tickets/*"
  ]
}
What comes back
{
  "connection": {
    "name": "zendesk",
    "base_url": "https://hansenvoss.zendesk.com/api/v2",
    "auth": "bearer",
    "header": null,
    "allow": [
      "GET /tickets*",
      "PUT /tickets/*"
    ],
    "description": "The old help desk, until the move is done",
    "created_at": "2026-10-14T08:00:00+00:00",
    "last_used_at": null
  }
}

Use it when

The agent needs a call the connection doesn't allow yet, or should lose one.

What it does

Replace the calls a connection may make. On accounts with an owner it waits for the owner's approval by default, so a key can't widen its own reach. $0.001.

What comes back

connection: the connection with its new allowed calls. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
connectionRequiredstringThe connection's name. 2 to 40 characters.
allowRequiredarray of stringsThe calls it may make: a method and a path pattern each, like "GET /v1/customers*" or "POST /v1/tickets". * matches anything. 1 to 50 items.

The call

Over MCP, call connect_set_rules on https://api.conecto.chat/mcp/connect. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/connect_set_rules \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connection":"zendesk","allow":["GET /tickets*","PUT /tickets/*"]}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No connection has that name.connect_list shows them.
invalid_input400An allowed call is not a method and a path.Write each like "GET /v1/customers*".

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md