Gestite le bacheche tramite API o da un assistente IA

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

L'API REST

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

Gli endpoint che utilizzerà più spesso:

• GET /v1/agency/boards — le Sue bacheche
• GET /v1/agency/boards/{id} — una bacheca con le relative colonne e schede
• POST /v1/agency/boards/{id}/cards — aggiunta di lavoro
• POST /v1/agency/boards/{id}/cards/{id}/move — spostamento dello stesso
• POST /v1/agency/boards/{id}/invites — generazione di un link di condivisione

Il token del link di condivisione viene restituito in quest'ultima chiamata e solo in questa chiamata. Ne memorizziamo un'impronta digitale, pertanto non esiste alcun endpoint in grado di rileggerlo: se il Suo script necessita del link, lo conservi dalla risposta.

Il server MCP

Se utilizza un assistente IA che supporta MCP, lo colleghi per fargli ottenere direttamente gli strumenti per le bacheche: elencare le bacheche, leggerne una per intero, creare una bacheca, aggiungere una scheda, spostare una scheda, commentare, creare un link di condivisione e revocarne uno. Ciò trasforma "riassumi questa settimana e invia un link ad Acme" in una singola istruzione invece di richiedere due sistemi e un'operazione di copia-incolla.

Due aspetti da sapere su questi strumenti:

• Una nuova scheda è interna a meno che non indichi diversamente. Un assistente che riassume il Suo lavoro interno non deve pubblicare tale riepilogo al Suo cliente solo perché nessuno gli ha detto di non farlo, pertanto visibility è impostato in modo predefinito su interno e deve essere configurato deliberatamente su client.
• La revoca di un link richiede una conferma, poiché rimuove anche chiunque si sia unito tramite quel link; lo strumento Le indicherà quante persone erano coinvolte, invece di segnalare semplicemente un esito positivo.

Requisiti

L'accesso alle API e a MCP è incluso in Boards Business e in ogni piano di hosting Agency. Su Boards Free e Boards Pro, gli endpoint delle bacheche rispondono con un messaggio che segnala tale condizione.

Una chiave API o una connessione MCP può eseguire solo ciò che la persona che l'ha creata è autorizzata a fare, all'interno delle organizzazioni in cui ha i permessi per farlo. Un link di condivisione creato da un assistente è vincolato allo stesso modo: non può concedere un ruolo che la persona autorizzante non possiede direttamente.