Điều khiển bảng từ API hoặc từ trợ lý AI

Các bảng hoàn toàn có thể điều khiển được từ bên ngoài trang tổng quan. Hai định tuyến, một mô hình phân quyền và hoạt động giống hệt như các màn hình giao diện — bởi vì chúng gọi cùng một mã nguồn.

The REST API

Mọi thao tác đều có trong đặc tả OpenAPI công khai của chúng tôi, với các client được tạo sẵn bằng TypeScript, Python, PHP và Go, đồng thời CLI cũng được tạo từ chính đặc tả đó. Bảng, cột, thẻ, bình luận, câu hỏi, nhãn, thành viên và liên kết chia sẻ đều được hỗ trợ đầy đủ.

Các endpoint quý khách sẽ sử dụng nhiều nhất:

• GET /v1/agency/boards — các bảng của quý khách
• GET /v1/agency/boards/{id} — một bảng cùng các cột và thẻ của bảng đó
• POST /v1/agency/boards/{id}/cards — thêm công việc
• POST /v1/agency/boards/{id}/cards/{id}/move — di chuyển thẻ
• POST /v1/agency/boards/{id}/invites — tạo một liên kết chia sẻ

Token của liên kết chia sẻ chỉ được trả về ở lệnh gọi cuối cùng đó và chỉ duy nhất ở lệnh gọi đó. Chúng tôi lưu trữ một mã nhận dạng (fingerprint) của nó, vì vậy không có endpoint nào có thể đọc lại mã này — nếu tập lệnh của quý khách cần liên kết, hãy lưu giữ nó từ phản hồi.

The MCP server

Nếu quý khách sử dụng một trợ lý AI hỗ trợ MCP, hãy kết nối nó và trợ lý sẽ trực tiếp có được các công cụ quản lý bảng: liệt kê các bảng, đọc toàn bộ một bảng, tạo bảng, thêm thẻ, di chuyển thẻ, bình luận, tạo liên kết chia sẻ và thu hồi liên kết. Điều đó biến yêu cầu "tóm tắt tuần này và gửi cho Acme một liên kết" thành một lệnh duy nhất thay vì phải thao tác trên hai hệ thống và sao chép-dán.

Hai điều quý khách cần biết về các công cụ:

• Một thẻ mới sẽ ở chế độ nội bộ trừ khi quý khách chỉ định khác. Trợ lý tóm tắt công việc nội bộ của quý khách không được phép đăng bản tóm tắt đó cho khách hàng chỉ vì không ai yêu cầu không làm vậy, do đó visibility mặc định là nội bộ và phải được chủ động đặt thành client.
• Việc thu hồi liên kết sẽ yêu cầu xác nhận, vì thao tác này cũng xóa bất kỳ ai đã tham gia qua liên kết đó — và công cụ sẽ cho quý khách biết có bao nhiêu người bị ảnh hưởng, thay vì chỉ thông báo thành công đơn thuần.

Những điều kiện cần thiết

Quyền truy cập API và MCP được bao gồm trong gói Boards Business và trong mọi gói hosting Agency. Trên Boards Free và Boards Pro, các endpoint của bảng sẽ phản hồi bằng một thông báo cho biết điều này.

Khóa API hoặc kết nối MCP chỉ có thể thực hiện những gì người tạo ra nó có quyền thực hiện, trong các tổ chức mà họ được phép thao tác. Liên kết chia sẻ do trợ lý tạo ra cũng bị giới hạn theo cách tương tự: liên kết đó không thể cấp vai trò mà chính người ủy quyền không sở hữu.