Pilotez des tableaux depuis l'API ou depuis un assistant IA

Les tableaux sont entièrement pilotables depuis l'extérieur du tableau de bord. Deux routes, un modèle d'autorisation et le même comportement que les écrans, car ils font appel au même code.

L'API REST

Chaque opération figure dans notre spécification OpenAPI publique, avec des clients générés en TypeScript, Python, PHP et Go, et l'interface CLI est générée à partir de la même spécification. Les tableaux, colonnes, cartes, commentaires, questions, libellés, 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 une tâche
• POST /v1/agency/boards/{id}/cards/{id}/move — la 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 celui-ci. Nous en stockons une empreinte, aucun point de terminaison ne peut donc 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 compatible MCP, connectez-le pour qu'il accède directement aux outils de tableau : lister les tableaux, en lire un intégralement, 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 la consigne "résume la semaine et envoie un lien à Acme" en une seule instruction au lieu de deux systèmes et d'un copier-coller.

Deux choses à savoir sur ces outils :

• Une nouvelle carte est interne, sauf indication contraire. Un assistant résumant votre travail interne ne doit pas publier ce résumé chez votre client sous prétexte qu'aucune consigne ne l'interdisait. Par conséquent, la visibility est définie par défaut sur interne et doit être configurée explicitement sur client.
• La révocation d'un lien demande une confirmation, car elle supprime également toutes les personnes ayant rejoint le système via ce lien, et l'outil indique le nombre de personnes concernées plutôt que de se contenter d'un succès discret.

Prérequis

L'accès par API et MCP est inclus dans Boards Business et dans chaque formule d'hébergement Agency. Avec Boards Free et Boards Pro, les points de terminaison des tableaux répondent par un message explicite.

Une clé API ou une connexion MCP ne peut effectuer que les actions autorisées pour la personne qui l'a créée, au sein des organisations où elle dispose de ces droits. Un lien de partage créé par un assistant est soumis aux mêmes limites : il ne peut accorder un rôle que l'humain à l'origine de l'autorisation possède lui-même.