Ovládejte nástěnky přes API nebo pomocí AI asistenta

Nástěnky lze plně ovládat i mimo administrační rozhraní. Dvě trasy, jeden model oprávnění a stejné chování jako na obrazovkách — protože volají stejný kód.

Rozhraní REST API

Každá operace je uvedena v naší veřejné specifikaci OpenAPI s vygenerovanými klienty v jazycích TypeScript, Python, PHP a Go a ze stejné specifikace se generuje i CLI. Zahrnuty jsou nástěnky, sloupce, karty, komentáře, otázky, štítky, členové i odkazy pro sdílení.

Koncové body, které budete používat nejčastěji:

• GET /v1/agency/boards — vaše nástěnky
• GET /v1/agency/boards/{id} — jedna nástěnka se svými sloupci a kartami
• POST /v1/agency/boards/{id}/cards — přidat úkol
• POST /v1/agency/boards/{id}/cards/{id}/move — přesunout jej
• POST /v1/agency/boards/{id}/invites — vygenerovat odkaz pro sdílení

Token odkazu pro sdílení je vrácen při tomto posledním volání a pouze při tomto volání. Ukládáme pouze jeho otisk, takže neexistuje žádný koncový bod, který by jej mohl znovu načíst — pokud váš skript odkaz potřebuje, uložte si jej z odpovědi.

Server MCP

Pokud používáte asistenta AI, který podporuje protokol MCP, připojte jej a získá přímý přístup k nástrojům pro práci s nástěnkami: zobrazení seznamu nástěnek, načtení celé nástěnky, vytvoření nástěnky, přidání karty, přesunutí karty, přidání komentáře, vytvoření odkazu pro sdílení i jeho zneplatnění. To promění požadavek „vytvoř shrnutí tohoto týdne a pošli společnosti Acme odkaz“ v jediný pokyn namísto práce ve dvou systémech a kopírování textu.

Dvě věci, které stojí za to o těchto nástrojích vědět:

• Nová karta je interní, pokud neurčíte jinak. Asistent shrnující vaši interní práci nesmí toto shrnutí zveřejnit klientovi jen proto, že to nikdo nezakázal, takže výchozí hodnota parametru visibility je interní a musí být záměrně nastavena na client.
• Zneplatnění odkazu vyžaduje potvrzení, protože také odebere každého, kdo se přes tento odkaz připojil — a nástroj vám sdělí, o kolik lidí šlo, namísto pouhého hlášení o úspěchu.

Co je k tomu potřeba

Přístup k API a MCP je zahrnut v tarifu Boards Business a v každém hostingovém plánu Agency. U tarifů Boards Free a Boards Pro odpovídají koncové body nástěnek zprávou, která na tuto skutečnost upozorňuje.

Klíč API nebo připojení MCP může provádět pouze to, co může provádět osoba, která jej vytvořila, a to v organizacích, v nichž k tomu má oprávnění. Odkaz pro sdílení vytvořený asistentem je omezen stejným způsobem: nemůže udělit roli, kterou autorizující osoba sama nemá.