---
title: "Đổi khoá API của kết nối"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/connections.rotate_key
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Đổi khoá API của kết nối

Cấp khoá API mới cho một kết nối khác (khoá cũ ngừng hoạt động).

Cấp khoá API mới cho một kết nối khác (khoá cũ ngừng hoạt động).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `connections.rotate_key` |
| Scope cần | `integrations.manage` |
| Mức | Nguy hiểm |
| Có thể cần xác nhận | Có |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager` |
| Trong app | Cài đặt → Kết nối AI → Đổi khoá |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `id` | `uuid` | Có |   |

## Ví dụ gọi

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

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

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

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "apiKey": "text"
  }
}
```

## 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: "connections.rotate_key"`. Tên tool khi được liệt kê: `connections_rotate_key`.