Reference
Reorder chat folders
Set the folder tab order with Telegram folder ids (telegramId from folders.list); folders left out keep their order after them.
View MarkdownThis page is generated from the source code on every release.
Set the folder tab order with Telegram folder ids (telegramId from folders.list); folders left out keep their order after them.
Overview
| Name | Value |
|---|---|
| Code | folders.reorder |
| Scope needed | messages.manage |
| Risk | Write |
| May need confirmation | No |
| Runs as | Queues work for a node |
Needs Idempotency-Key |
Yes |
| Member roles allowed | owner, manager, agent |
| Needs a worker from version | 1.0.33 |
| In the app | Inbox → pick one account → folder tabs → Edit folders |
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
accountId |
uuid |
Yes | |
order |
integer[] |
Yes |
Example request
curl -X POST https://tlg.builera.app/api/public/v2/ops/folders.reorder \
-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","order":[]}'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: "folders.reorder". Tool name when listed: folders_reorder.