Pilotez des tableaux depuis l’API ou depuis un assistant d’IA

Les tableaux sont entièrement pilotables depuis l’extérieur du tableau de bord. Deux voies, un seul modèle d’autorisation et le même comportement que les écrans — car ils appellent le même code.

L’API REST

Chaque opération figure dans notre spécification publique OpenAPI, avec des clients générés en TypeScript, Python, PHP et Go, et le CLI est généré à partir de cette même spécification. Les tableaux, colonnes, cartes, commentaires, questions, étiquettes, membres et liens de partage sont tous pris en charge.

Les points de terminaison que vous utiliserez le plus :

• GET /v1/agency/boards — vos tableaux
• GET /v1/agency/boards/{id} — un tableau avec ses colonnes et ses cartes
• POST /v1/agency/boards/{id}/cards — ajouter du travail
• POST /v1/agency/boards/{id}/cards/{id}/move — le déplacer
• POST /v1/agency/boards/{id}/invites — générer un lien de partage

Le jeton du lien de partage est renvoyé lors de ce dernier appel et uniquement lors de cet appel. Nous en conservons une empreinte, il n’existe donc aucun point de terminaison capable de le relire — si votre script a besoin du lien, conservez-le à partir de la réponse.

Le serveur MCP

Si vous utilisez un assistant IA prenant en charge MCP, connectez-le et il obtiendra directement les outils de tableau : lister les tableaux, en lire un dans son intégralité, créer un tableau, ajouter une carte, déplacer une carte, commenter, créer un lien de partage et en révoquer un. Cela transforme « résume cette semaine et envoie un lien à Acme » en une seule instruction au lieu de deux systèmes et d’un copier-coller.

Deux choses utiles à savoir sur les outils :

• Une nouvelle carte est interne, sauf indication contraire de votre part. Un assistant qui résume votre travail interne ne doit pas publier ce résumé à votre client sous prétexte que personne ne lui a dit de ne pas le faire ; ainsi, visibility est défini par défaut sur interne et doit être configuré délibérément sur client.
• La révocation d’un lien nécessite une confirmation, car elle supprime également toute personne ayant rejoint via ce lien — et l’outil vous indique combien de personnes cela représentait, plutôt que de signaler un simple succès.

Ce dont il a besoin

L’accès à l’API et au MCP est inclus dans Boards Business et dans chaque formule d’hébergement Agency. Sur Boards Free et Boards Pro, les points de terminaison des tableaux répondent par un message l’indiquant.

Une clé d’API ou une connexion MCP ne peut faire que ce que la personne qui l’a créée peut faire, dans les organisations où elle peut le faire. Un lien de partage créé par un assistant est restreint de la même manière : il ne peut pas octroyer un rôle que la personne ayant accordé l’autorisation ne détient pas elle-même.