Gestisci le bacheche tramite l'API o con un assistente IA

I tabelloni sono completamente gestibili dall'esterno della dashboard. Due percorsi, un unico modello di autorizzazione e lo stesso comportamento delle schermate, poiché richiamano lo stesso codice.

L'API REST

Ogni operazione è inclusa nella nostra specifica OpenAPI pubblica, con client generati in TypeScript, Python, PHP e Go, e la CLI è generata a partire dalla stessa specifica. Tabelloni, colonne, schede, commenti, domande, etichette, membri e link di condivisione sono tutti coperti.

Gli endpoint che utilizzerete più spesso:

• GET /v1/agency/boards — i vostri tabelloni
• GET /v1/agency/boards/{id} — un tabellone con le relative colonne e schede
• POST /v1/agency/boards/{id}/cards — aggiunge lavoro
• POST /v1/agency/boards/{id}/cards/{id}/move — lo sposta
• POST /v1/agency/boards/{id}/invites — genera un link di condivisione

Il token del link di condivisione viene restituito da quest'ultima chiamata e solamente da quella. Ne memorizziamo un'impronta digitale, quindi non esiste alcun endpoint in grado di leggerlo nuovamente: se il vostro script necessita del link, conservatelo dalla risposta.

Il server MCP

Se utilizzate un assistente IA che supporta MCP, collegatelo per fornirgli direttamente gli strumenti per i tabelloni: elencare i tabelloni, leggerne uno integralmente, creare un tabellone, aggiungere una scheda, spostare una scheda, commentare, creare un link di condivisione e revocarne uno. Questo trasforma "riassumi questa settimana e invia un link ad Acme" in un'unica istruzione invece di due sistemi e un copia-incolla.

Due aspetti importanti da conoscere sugli strumenti:

• Una nuova scheda è interna a meno che non specifichiate diversamente. Un assistente che riassume il vostro lavoro interno non deve pubblicare tale riassunto per il vostro cliente semplicemente perché nessuno ha detto il contrario, pertanto visibility è impostata su interna per predefinita e deve essere definita come client in modo esplicito.
• La revoca di un link richiede una conferma, poiché rimuove anche chiunque si sia unito tramite quel link, e lo strumento vi indica quante persone fossero coinvolte, anziché segnalare un pulito successo.

Requisiti

L'accesso API e MCP è incluso in Boards Business e in qualsiasi piano di hosting Agency. Nei piani Boards Free e Boards Pro, gli endpoint dei tabelloni rispondono con un messaggio che lo segnala.

Una chiave API o una connessione MCP può eseguire esclusivamente le azioni consentite alla persona che l'ha creata, all'interno delle organizzazioni in cui dispone di tali permessi. Un link di condivisione creato da un assistente è limitato allo stesso modo: non può concedere un ruolo che l'umano che lo autorizza non possiede in prima persona.