Steruj tablicami za pomocą API lub asystenta SI

Tablicami można w pełni sterować spoza panelu nawigacyjnego. Dwie ścieżki, jeden model uprawnień i dokładnie takie samo zachowanie jak na ekranach — 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) powstaje na podstawie tej samej specyfikacji. Tablice, kolumny, karty, komentarze, pytania, etykiety, członkowie oraz linki do udostępniania — wszystko to jest objęte obsługą.

Punkty końcowe, z których będą Państwo korzystać najczęściej:

• GET /v1/agency/boards — Państwa tablice
• GET /v1/agency/boards/{id} — jedna tablica wraz z kolumnami i kartami
• POST /v1/agency/boards/{id}/cards — dodawanie zadań
• POST /v1/agency/boards/{id}/cards/{id}/move — przenoszenie ich
• POST /v1/agency/boards/{id}/invites — generowanie linku do udostępniania

Token linku do udostępniania jest zwracany przy tym ostatnim wywołaniu i wyłącznie przy nim. Przechowujemy jedynie jego cyfrowy odcisk, więc żaden punkt końcowy nie może go ponownie odczytać — jeśli Państwa skrypt potrzebuje tego linku, należy zapisać go z odpowiedzi.

Serwer MCP

Jeśli korzystają Państwo z asystenta SI obsługującego protokół MCP, po połączeniu uzyska on bezpośredni dostęp do narzędzi tablicy: listowania tablic, odczytywania całej tablicy, tworzenia nowej, dodawania karty, przesuwania jej, komentowania, generowania oraz unieważniania linku do udostępniania. Dzięki temu polecenie typu „podsumuj ten tydzień i wyślij firmie Acme link” staje się jedną instrukcją zamiast konieczności operowania na dwóch systemach i kopiowania danych.

Dwie kwestie, o których warto wiedzieć w kontekście tych narzędzi:

• Nowa karta jest wewnętrzna, chyba że określą Państwo inaczej. Asystent podsumowujący Państwa wewnętrzne zadania nie może opublikować tego podsumowania klientowi tylko dlatego, że nikt mu tego nie zabronił, dlatego parametr visibility ma domyślnie wartość wewnętrzną i musi zostać celowo zmieniony na client.
• Unieważnienie linku wymaga potwierdzenia, ponieważ usuwa ono również każdą osobę, która dołączyła za jego pośrednictwem — a narzędzie poinformuje o dokładnej liczbie tych osób, zamiast jedynie zwracać lakoniczny komunikat o sukcesie.

Wymagania

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

Klucz API lub połączenie MCP może wykonywać tylko te czynności, do których uprawniona jest osoba, która je utworzyła, i wyłącznie w organizacjach, w których ma ona odpowiednie prawa. Link do udostępniania utworzony przez asystenta podlega tym samym ograniczeniom: nie może nadać roli, której upoważniający użytkownik sam nie posiada.