---
title: "Reload chat folders from Telegram"
locale: en
url: https://tlg.builera.app/en/docs/reference/rest/folders.sync
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Reload chat folders from Telegram

Read the account's folders from Telegram again (changes made on the phone also arrive by themselves). Follow the operation, then call folders.list.

Read the account's folders from Telegram again (changes made on the phone also arrive by themselves). Follow the operation, then call folders.list.

## Overview

| Name | Value |
| --- | --- |
| Code | `folders.sync` |
| Scope needed | `messages.read` |
| Risk | Read |
| May need confirmation | No |
| Runs as | Queues work for a node |
| Needs `Idempotency-Key` | No |
| 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 |   |

## Example request

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/folders.sync \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accountId":"00000000-0000-0000-0000-000000000000"}'
```

## Output fields (`data`)

| Field | Type | Required |
| --- | --- | --- |
| `ok` | `true` | Yes |
| `jobId` | `text` | Yes |

## Example answer

```json
{
  "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.sync"`. Tool name when listed: `folders_sync`.
