Docs

Reference

Adopt an existing bot of the account

Bring in a bot this account already owns (@BotFather /token): the app stores its token sealed and can then manage it.

View MarkdownThis page is generated from the source code on every release.

Bring in a bot this account already owns (@BotFather /token): the app stores its token sealed and can then manage it.

Overview

Name Value
Code bots.adopt
Scope needed bots.manage
Risk Write
May need confirmation No
Runs as Answers right away
Needs Idempotency-Key No
Member roles allowed owner, manager
Needs a worker from version 1.0.37
In the app Bots → Add an existing bot

Input fields

Field Type Required Description
accountId uuid Yes
username text Yes

Example request

curl -X POST https://tlg.builera.app/api/public/v2/ops/bots.adopt \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accountId":"00000000-0000-0000-0000-000000000000","username":"…"}'

Output fields (data)

Field Type Required
ok true Yes
jobId text Yes

Example answer

{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}

Using it over MCP

Not listed on any profile: call tools_describe then tools_run with code: "bots.adopt". Tool name when listed: bots_adopt.

Was this page helpful?

Last checked: 10/24/2026 · build 2.0