Управляйте досками через API или с помощью ИИ-ассистента

Досками можно полностью управлять извне панели управления. Два маршрута, одна модель разрешений и такое же поведение, как и на экранах — потому что они вызывают один и тот же код.

REST API

Каждая операция описана в нашей публичной спецификации OpenAPI, со сгенерированными клиентами на TypeScript, Python, PHP и Go, а интерфейс командной строки (CLI) сгенерирован из той же спецификации. Доски, колонки, карточки, комментарии, вопросы, метки, участники и ссылки для общего доступа — поддерживается всё.

Эндпоинты, которые вы будете использовать чаще всего:

• GET /v1/agency/boards — ваши доски
• GET /v1/agency/boards/{id} — одна доска с её колонками и карточками
• POST /v1/agency/boards/{id}/cards — добавить работу
• POST /v1/agency/boards/{id}/cards/{id}/move — переместить её
• POST /v1/agency/boards/{id}/invites — создать ссылку для общего доступа

Токен ссылки для общего доступа возвращается при этом последнем вызове и только при этом вызове. Мы сохраняем его цифровой отпечаток, поэтому нет эндпоинта, который мог бы прочитать его снова — если вашему скрипту нужна ссылка, сохраните её из ответа.

Сервер MCP

Если вы используете ИИ-ассистента с поддержкой MCP, подключите его, и он получит инструменты доски напрямую: просматривать доски, читать доску целиком, создавать доску, добавлять карточку, перемещать карточку, комментировать, создавать ссылку для общего доступа и отзывать её. Это превращает задачу «составь сводку за эту неделю и отправь ссылку в Acme» в одну инструкцию вместо двух систем и копирования с вставкой.

Две вещи, о которых стоит знать касательно инструментов:

• Новая карточка является внутренней, если вы не укажете иное. Ассистент, подводящий итоги вашей внутренней работы, не должен публиковать эту сводку вашему клиенту просто потому, что никто не просил этого не делать, поэтому параметр visibility по умолчанию имеет значение internal и должен быть явно установлен в client.
• Отзыв ссылки требует подтверждения, поскольку он также удаляет всех, кто присоединился по этой ссылке — и инструмент сообщает вам, сколько это было человек, а не просто рапортует об успешном выполнении.

Что для этого нужно

Доступ к API и MCP включен в Boards Business и в каждый тарифный план хостинга Agency. На тарифах Boards Free и Boards Pro эндпоинты досок возвращают соответствующее информационное сообщение.

Ключ API или соединение MCP могут выполнять только то, что разрешено создавшему их человеку, и в тех организациях, где у него есть соответствующие права. Ссылка для общего доступа, созданная ассистентом, ограничена точно так же: она не может предоставить роль, которой не обладает сам авторизующий пользователь.