> ## Documentation Index
> Fetch the complete documentation index at: https://monitor-docs.solobiz.academy/llms.txt
> Use this file to discover all available pages before exploring further.

# API key

> Tạo và thu hồi API key cho AI agent: quyền viewer và editor, đặt tên theo agent, key chỉ hiện một lần, prompt chứa key thật.

API key cho phép agent hoặc bot làm việc trong **một workspace** mà không cần tài khoản người dùng. Chỉ admin workspace tạo và thu hồi key.

## Tạo key

**1. Mở trang API key**

Vào **Cài đặt**, trang API key.

**2. Bấm Tạo API key**

Nhập **Tên** để nhận biết, chọn **Quyền**, bấm **Tạo**.

**3. Sao chép và lưu**

Hộp thoại **API key đã được tạo** hiện key và các prompt dựng sẵn theo từng agent. Sao chép prompt đúng tab rồi bấm **Tôi đã lưu key**.

> [!WARNING]
>
> API key **chỉ hiện một lần** khi tạo. Đóng hộp thoại là không xem lại được. Prompt cho agent
> **chứa luôn key thật**: xem nó như mật khẩu, đừng dán vào chat công khai, ticket hay git.
> Nếu lộ, thu hồi key và tạo key mới.

## Viewer hay Editor

| Quyền | Làm được | Dùng khi |
| - | - | - |
| **Viewer** (chỉ đọc) | Xem kênh, bài, trạng thái đăng, hộp bình luận | Agent chỉ báo cáo, theo dõi |
| **Editor** (đọc và ghi) | Mọi thứ của viewer, cộng đăng/xoá bài, bình luận đầu, trả lời, nhắn riêng, ẩn, đánh dấu đã xử lý | Agent đăng bài hoặc trả lời bình luận |

Nên cho quyền thấp nhất đủ dùng. Agent chỉ đọc thì dùng Viewer.

## Đặt tên theo agent

Đặt tên key theo agent dùng nó, ví dụ `claude-code-posting`, `grokbot-inbox`. Tên này hiện trong lịch sử thao tác của hộp bình luận và ở cột **Người tạo** của lịch đăng, nên bạn biết agent nào làm gì. Mỗi agent một key riêng để thu hồi từng cái khi cần.

## Danh sách key

Bảng hiện **Tên**, **Key**, **Quyền**, **Dùng lần cuối**, **Tạo lúc**, **Trạng thái** (Hoạt động / Đã thu hồi). Key không dùng lâu hoặc không rõ chủ thì thu hồi.

## Thu hồi key

Bấm **Thu hồi** ở dòng key và xác nhận. Mọi hệ thống đang dùng key mất quyền ngay, đây cũng là cách dừng một agent.

## Giới hạn

Mỗi key gọi tối đa **120 request mỗi phút**, tính chung mọi thao tác. Vượt thì nhận lỗi 429, agent cần chờ rồi thử lại.

## Ví dụ key (giả)

```text theme={null}
smk_0a1b2c3d_<chuỗi bí mật dài 43 ký tự>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.