Zarządzaj tablicami za pomocą interfejsu API lub asystenta AI

Tablice można w pełni obsługiwać spoza panelu sterowania. Dwie ścieżki, jeden model uprawnień i takie samo zachowanie jak w przypadku ekranów — ponieważ wywołują ten sam kod.

Interfejs REST API

Każda operacja znajduje się w naszej publicznej specyfikacji OpenAPI z wygenerowanymi klientami w językach TypeScript, Python, PHP i Go, a interfejs wiersza poleceń (CLI) jest generowany na podstawie tej samej specyfikacji. Obsługiwane są tablice, kolumny, karty, komentarze, pytania, etykiety, członkowie oraz linki udostępniania.

Najczęściej używane punkty końcowe:

• GET /v1/agency/boards — Twoje tablice
• GET /v1/agency/boards/{id} — pojedyncza tablica wraz z jej kolumnami i kartami
• POST /v1/agency/boards/{id}/cards — dodaj zadanie
• POST /v1/agency/boards/{id}/cards/{id}/move — przesuń je
• POST /v1/agency/boards/{id}/invites — wygeneruj link udostępniania

Token linku udostępniania jest zwracany w tym ostatnim zapytaniu i wyłącznie w nim. Przechowujemy jego odcisk palca, więc nie ma punktu końcowego, który pozwalałby na jego odczytanie — jeśli skrypt potrzebuje linku, należy go zachować z odpowiedzi.

Serwer MCP

Jeśli korzystasz z asystenta AI obsługującego protokół MCP, połącz go, aby zyskać bezpośredni dostęp do narzędzi tablic: wyświetlania listy tablic, pełnego odczytu jednej z nich, tworzenia tablicy, dodawania karty, przenoszenia karty, komentowania, tworzenia linku udostępniania oraz jego unieważniania. Dzięki temu polecenie „podsumuj ten tydzień i wyślij Acmo link” wymaga jednej instrukcji zamiast obsługi dwóch systemów i kopiowania.

Dwie rzeczy, które warto wiedzieć o narzędziach:

• Nowa karta ma status wewnętrznej, chyba że wskazano inaczej. Asystent podsumowujący Twoją pracę wewnętrzną nie może publikować tego podsumowania dla klienta tylko dlatego, że nikt tego nie zabronił, dlatego pole visibility domyślnie przyjmuje wartość „internal” i musi zostać celowo zmienione na „client”.
• Unieważnienie linku wymaga potwierdzenia, ponieważ usuwa ono również wszystkie osoby, które dołączyły za pośrednictwem tego linku — a narzędzie informuje, ile osób zostało usuniętych, zamiast zgłaszać ogólny sukces.

Wymagania

Dostęp do API i protokołu MCP jest zawarty w planie Boards Business oraz w każdym planie hostingowym Agency. W planach Boards Free i Boards Pro punkty końcowe tablic zwracają odpowiednią informację o braku dostępu.

Klucz API lub połączenie MCP mogą wykonać tylko te działania, na które pozwala osoba, która je utworzyła, w organizacjach, w których posiada odpowiednie uprawnienia. Link udostępniania utworzony przez asystenta jest ograniczony w taki sam sposób: nie może nadawać roli, której autoryzujący go człowiek sam nie posiada.