Stuur borden aan via de API of vanuit een AI-assistent

Boards zijn volledig aanstuurbaar van buiten het dashboard. Twee routes, één machtigingsmodel, en hetzelfde gedrag als de schermen — omdat ze dezelfde code aanroepen.

De REST API

Elke bewerking staat in onze openbare OpenAPI-specificatie, met gegenereerde clients in TypeScript, Python, PHP en Go, en de CLI is gegenereerd vanuit dezelfde specificatie. Boards, kolommen, kaarten, reacties, vragen, labels, leden en deellinks worden allemaal gedekt.

De eindpunten die u het meest zult gebruiken:

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

Het token van de deellink wordt geretourneerd bij die laatste aanroep en alleen bij die aanroep. We slaan er een vingerafdruk van op, dus er is geen eindpunt dat het opnieuw kan uitlezen — als uw script de link nodig heeft, bewaar deze dan vanuit het antwoord.

De MCP-server

Als u een AI-assistent gebruikt die MCP ondersteunt, verbind deze dan en hij krijgt rechtstreeks toegang tot boardtools: boards weergeven, er één volledig lezen, een board 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 knip-en-plakwerk.

Twee dingen die het weten waard zijn over de tools:

• Een nieuwe kaart is intern, tenzij u anders aangeeft. Een assistent die uw interne werk samenvat, mag die samenvatting niet zomaar naar uw klant publiceren omdat niemand zei dat het niet mocht; daarom staat visibility standaard op intern en moet dit bewust worden ingesteld op client.
• Het intrekken van een link vraagt om bevestiging, omdat het ook iedereen verwijdert die via die link lid is geworden — en de tool laat u zien om hoeveel mensen dat ging, in plaats van alleen een keurige succesmelding te geven.

Wat ervoor nodig is

API- en MCP-toegang is inbegrepen in Boards Business en in elk Agency-hostingpakket. Op Boards Free en Boards Pro antwoorden de board-eindpunten met een bericht waarin dit wordt uitgelegd.

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