Reference
Turn topics on / off
Turn forum topics on or off for a supergroup (needs the right to change group info). Turning them off keeps the messages but removes the topic structure.
View MarkdownThis page is generated from the source code on every release.
Turn forum topics on or off for a supergroup (needs the right to change group info). Turning them off keeps the messages but removes the topic structure.
Overview
| Name | Value |
|---|---|
| Code | groups.toggle_topics |
| Scope needed | groups.admin |
| Risk | Write |
| May need confirmation | Yes |
| Runs as | Queues work for a node |
Needs Idempotency-Key |
Yes |
| Member roles allowed | owner, manager, agent |
| Needs a worker from version | 1.0.23 |
| In the app | Inbox → group info → Manage → Topics |
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
conversationId |
uuid |
Yes | |
enabled |
true/false |
Yes |
Example request
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.toggle_topics \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: <unique key per operation>" \
-d '{"conversationId":"00000000-0000-0000-0000-000000000000","enabled":true}'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: "groups.toggle_topics". Tool name when listed: groups_toggle_topics.