Управлявайте таблата чрез API или от AI асистент

Таблата са напълно управляеми извън контролния панел. Два маршрута, един модел за разрешения и същото поведение като на екраните — защото извикват един и същ код.

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 връзка може да прави само това, което лицето, което ги е създало, има право да прави, и то само в организациите, в които има това право. Връзка за споделяне, създадена от асистент, е ограничена по същия начин: тя не може да предостави роля, която самият упълномощаващ потребител не притежава.