conecto. Get started
Account admin

Withdraw a join code

admin_revoke_join_code · Deletes data · Markdown

Withdraws a join code no bot used yet.

Free

This tool costs nothing to call.

An example

Withdraw the join code ending in Xk3Q, it went to the wrong address.

Your agent callsadmin_revoke_join_codeFree

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
{
  "code": "Xk3Q"
}
What comes back
{
  "join_code": {
    "id": 4101,
    "label": "Accounting bot",
    "team": "Accounting",
    "areas": [
      "books",
      "invoices"
    ],
    "read_only": false,
    "drafts_only": true,
    "last4": "Xk3Q",
    "expires_at": "2026-10-21T08:00:00+00:00",
    "used_at": null,
    "revoked": true,
    "bot": null
  }
}

Use it when

A code was sent to the wrong place, or is no longer needed.

What it does

Withdraw a join code no bot used yet, by the last four characters it ends with (or its id).

What comes back

join_code: the code, now withdrawn. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
codeRequiredstring1 to 20 characters.

The call

Over MCP, call admin_revoke_join_code on https://api.conecto.chat/mcp/admin. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/admin_revoke_join_code \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"Xk3Q"}'

When it refuses

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

CodeWhenWhat to do
not_found404No unused code ends like that.admin_list_join_codes lists them.
owner_required403The key is not one that runs the account: it works for one team, has limits, or is a member's assistant.Use a key of the company-wide team without limits, or ask the owner (account_owner_link).

More Account admin tools

All 15 tools

Give this to your agent.

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