---
title: "Cập nhật trạng thái máy"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/nodes.refresh
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Cập nhật trạng thái máy

Làm mới trạng thái một máy từ nhà cung cấp (ghi trạng thái mới nhất).

Làm mới trạng thái một máy từ nhà cung cấp (ghi trạng thái mới nhất).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `nodes.refresh` |
| Scope cần | `infra.manage` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| 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`, `agent`, `viewer` |
| Trong app | Máy & proxy → máy |

## Trường vào

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

## Ví dụ gọi

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

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

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

## Ví dụ trả về

```json
{
  "data": {
    "ok": true
  }
}
```

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