---
title: "Ghim / bỏ ghim chủ đề"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.pin_topic
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Ghim / bỏ ghim chủ đề

Ghim một chủ đề diễn đàn lên đầu danh sách chủ đề, hoặc bỏ ghim.

Ghim một chủ đề diễn đàn lên đầu danh sách chủ đề, hoặc bỏ ghim.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.pin_topic` |
| Scope cần | `groups.admin` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Xếp việc cho máy chạy |
| Cần `Idempotency-Key` | Có |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Cần máy chạy từ bản | `1.0.37` |
| Trong app | Hộp thư → thông tin nhóm → Quản lý (Build 1.8) |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `topicId` | `số nguyên` | Có |   |
| `pinned` | `đúng/sai` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.pin_topic \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000","topicId":1,"pinned":true}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `jobId` | `chữ` | Có |

## Ví dụ trả về

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

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "groups.pin_topic"`. Tên tool khi được liệt kê: `groups_pin_topic`.