Quản lý bảng từ API hoặc từ trợ lý AI

Các bảng có thể điều khiển hoàn toàn từ bên ngoài bảng điều khiển. Hai tuyến đường, một mô hình quyền và hành vi giống như các màn hình — bởi vì chúng gọi cùng một mã.

API REST

Mọi thao tác đều nằm trong thông số kỹ thuật OpenAPI công khai của chúng tôi, với các máy khách được tạo bằng TypeScript, Python, PHP và Go, và CLI được tạo từ cùng một thông số kỹ thuật. Các 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ợ.

Các điểm cuối bạn sẽ sử dụng nhiều nhất:

• GET /v1/agency/boards — bảng của bạn
• GET /v1/agency/boards/{id} — một bảng với các cột và thẻ của nó
• 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 liên kết chia sẻ

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

Máy chủ MCP

Nếu bạn sử dụng trợ lý AI hỗ trợ MCP, hãy kết nối trợ lý đó và trợ lý sẽ nhận trực tiếp các công cụ bảng: liệt kê 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 "tóm tắt tuần này và gửi cho Acme một liên kết" thành một hướng dẫn thay vì hai hệ thống và thao tác sao chép-dán.

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

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

Yêu cầu

Quyền truy cập API và MCP được bao gồm trong Boards Business và trong mọi gói lưu trữ Agency. Trên Boards Free và Boards Pro, các điểm cuối của bảng sẽ trả về 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ó thể làm, trong các tổ chức mà họ có quyền. Liên kết chia sẻ do trợ lý tạo ra cũng bị giới hạn theo cùng một cách: nó không thể cấp một vai trò mà con người ủy quyền không có.