Borden aansturen via de API of via een AI-assistent

Borden zijn volledig aan te sturen van buiten het dashboard. Twee routes, één machtigingsmodel en exact hetzelfde gedrag als de schermen — omdat ze dezelfde code aanroepen.

De REST API

Elke bewerking bevindt zich in onze openbare OpenAPI-specificatie, met gegenereerde clients in TypeScript, Python, PHP en Go, en de CLI wordt gegenereerd op basis van dezelfde specificatie. Borden, kolommen, kaarten, reacties, vragen, labels, leden en deellinks worden allemaal gedekt.

De endpoints die u het meest zult gebruiken:

• GET /v1/agency/boards — uw borden
• GET /v1/agency/boards/{id} — één bord met de bijbehorende kolommen en kaarten
• POST /v1/agency/boards/{id}/cards — werk toevoegen
• POST /v1/agency/boards/{id}/cards/{id}/move — werk verplaatsen
• POST /v1/agency/boards/{id}/invites — een deellink genereren

Het token van de deellink komt terug bij die laatste aanroep en alleen bij die aanroep. Wij slaan hier een vingerafdruk van op, dus er is geen endpoint dat dit kan teruglezen — als uw script de link nodig heeft, bewaar deze dan uit de respons.

De MCP-server

Als u een AI-assistent gebruikt die MCP ondersteunt, verbind deze dan zodat deze direct over bordtools beschikt: borden weergeven, er één volledig lezen, een bord aanmaken, een kaart toevoegen, een kaart verplaatsen, reageren, een deellink aanmaken en er één intrekken. Dat verandert "vat deze week samen en stuur Acme een link" in één instructie in plaats van twee systemen en handmatig kopiëren en plakken.

Twee dingen die handig zijn om te weten over de tools:

• Een nieuwe kaart is intern, tenzij u anders aangeeft. Een assistent die uw interne werk samenvat, mag die samenvatting niet publiceren naar uw klant omdat niemand heeft gezegd dat dat niet mocht; daarom staat visibility standaard ingesteld op intern en moet dit bewust op client worden gezet.
• Het intrekken van een link vraagt om bevestiging, omdat hierbij ook iedereen wordt verwijderd die via die link is toegetreden — en de tool vertelt u om hoeveel mensen het ging, in plaats van een simpel succesbericht te tonen.

Wat hiervoor nodig is

API- en MCP-toegang is inbegrepen in Boards Business en in elk Agency-hostingabonnement. Bij Boards Free en Boards Pro antwoorden de bord-endpoints met een melding die dit aangeeft.

Een API-sleutel of MCP-verbinding kan alleen doen wat de persoon die deze heeft aangemaakt kan doen, binnen de organisaties waarin die persoon hiertoe bevoegd is. Een deellink die een assistent aanmaakt, is op dezelfde manier begrensd: deze kan geen rol toekennen die de autoriserende persoon zelf niet heeft.