Reference

End a Telegram session

Terminate another Telegram session of the account by its hash.

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

Terminate another Telegram session of the account by its hash.

Overview

Name	Value
Code	`accounts.kill_session`
Scope needed	`accounts.manage`
Risk	Dangerous
May need confirmation	Yes
Runs as	Queues work for a node
Needs `Idempotency-Key`	Yes
Member roles allowed	`owner`, `manager`
In the app	Accounts → Sessions

Input fields

Field	Type	Required	Description
`accountId`	`uuid`	Yes
`hash`	`text`	Yes

Example request

curl -X POST https://tlg.builera.app/api/public/v2/ops/accounts.kill_session \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <unique key per operation>" \
  -d '{"accountId":"00000000-0000-0000-0000-000000000000","hash":"…"}'

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: "accounts.kill_session". Tool name when listed: accounts_kill_session.

End a Telegram session

#Overview

#Input fields

#Example request

#Output fields (data)

#Example answer