Управляйте досками с помощью 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 по умолчанию задается значение «внутренний», и его нужно намеренно переключать на client.
• Для отзыва ссылки запрашивается подтверждение, поскольку это также удаляет всех, кто присоединился по этой ссылке, — и инструмент сообщает вам, сколько именно было таких людей, вместо того чтобы просто отрапортовать об успехе.

Что для этого требуется

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

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