Productivité
Miro dans votre produit et vos agents IA, via une API
Le toolkit Miro couvre boards, membres et éléments : liste et lecture de boards, création et mise à jour de sticky notes et cards, suppression d'éléments. Votre produit ou agent IA les appelle via Connect, qui gère la connexion OAuth du client et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/miro_create_board/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à Miro.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Miro. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Miro.
Boards créés par votre produit
Un SaaS crée un board Miro pour chaque nouveau projet et renvoie le viewLink à l'utilisateur.
Des données en sticky notes
Un outil d'agence ou de recherche ajoute des sticky notes de retours ou d'idées à un board, dans un frame si besoin.
Agent qui trie un board
Un agent IA liste les éléments d'un board, crée des cards assignées à des membres et met à jour leurs échéances.
Tools
12 tools Miro
- Lister les boardsGETListe les boards que l'utilisateur connecté peut ouvrir, avec id, name, description, viewLink, owner, team et dates. Pagination par offset.
- Obtenir un boardGETRenvoie un board : name, description, viewLink, owner, team, politique de partage et dates.
- Créer un boardPOSTCrée un board dans l'équipe de la connexion et le renvoie avec id et viewLink. Sur l'offre gratuite une équipe ne peut avoir que 3 boards modifiables.
- Mettre à jour un boardPATCHMet à jour le nom, la description ou le partage d'un board et le renvoie. Les champs omis gardent leur valeur.
- Lister les membres d'un boardGETListe les membres d'un board avec id, name et role. L'id est l'assigneeId que demandent Créer une card et Mettre à jour une card. Pagination par offset.
- Lister les élémentsGETListe les éléments d'un board, comme sticky notes, cards, textes, formes et frames, avec id, type, data, position, geometry et parent.
- Obtenir un élémentGETRenvoie un élément d'un board, de n'importe quel type, avec data, style, position, geometry et parent.
- Créer une sticky notePOSTAjoute une sticky note à un board et la renvoie avec son id. Sans position elle va au centre du board ; dans un frame (parent.id), la position se compte depuis le frame.
- Mettre à jour une sticky notePATCHMet à jour le texte, la forme, la couleur, la position, la taille ou le frame d'une sticky note et la renvoie. Les champs omis gardent leur valeur.
- Créer une cardPOSTAjoute une card, l'élément de tâche de Miro, à un board et la renvoie avec son id. Sans position elle va au centre du board ; dans un frame (parent.id), la position se compte depuis le frame.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/miro, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Miro
Dois-je intégrer l'API Miro moi-même ?
Non. Connect fournit 12 tools Miro décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Miro ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
