Vos agents ont leur place ici.

La requête la moins coûteuse, à effectuer en premier : elle confirme que la clé fonctionne et identifie le compte associé. Les autorisations des routes de salle reposent sur ce compte, pas sur la clé.

{
  "ok": true,
  "account": {
    "id": 4821,
    "name": "Ada Lovelace",
    "email": "ada@acme.com",
    "image": null,
    "plan": "2year",
    "locale": "en",
    "createdAt": "2026-07-02T09:14:00.000Z"
  },
  "customization": {
    "screenShare": true,
    "recording": true,
    "transcription": true,
    "chat": true,
    "handsFree": true,
    "youtube": true,
    "gdrive": true,
    "figma": true,
    "browserBox": true,
    "draw": true,
    "diagrams": true,
    "aiImages": true,
    "echo": true,
    "tasks": true
  },
  "key": {
    "id": 17,
    "name": "release-bot",
    "scopes": [
      "account:read",
      "rooms:read",
      "rooms:write"
    ]
  }
}

Modifier le profil (l’adresse e-mail ne peut pas être modifiée)

Marquer une notification comme lue.

Toutes les salles dont le compte est membre, de la plus récente à la plus ancienne. Le champ `roomId` correspond au paramètre `:roomId` utilisé dans la suite de cette documentation.

{
  "ok": true,
  "rooms": [
    {
      "roomId": "9f2c1a7e-4d3b-4c88-9a11-6e5f0b2d7c34",
      "name": "Sprint 24 review",
      "createdAt": "2026-08-26T10:02:11.000Z",
      "coverImage": null,
      "isTemporary": false,
      "url": "/roomV3/9f2c1a7e-4d3b-4c88-9a11-6e5f0b2d7c34"
    }
  ]
}

Crée la salle. Transmettez `actions` pour la créer **déjà préparée**, avec un tableau présent avant son ouverture. Vous partagez ainsi un espace de travail prêt, pas seulement un lien.

Métadonnées de la salle : folderId, memberCount, figmaEnabled.

Réservé au créateur de la salle. Un copropriétaire reçoit `creator_required` : être propriétaire d’une salle ne signifie pas l’avoir créée.

Réservé au CRÉATEUR de la salle. Un copropriétaire reçoit creator_required.

Rôle editor ou supérieur ; URL HTTPS uniquement (ou null pour effacer)

Tout le tableau sérialisé en Markdown typé. La requête adaptée pour fournir le tableau comme contexte à un modèle.

Sérialisation de tout le tableau en Markdown typé.

Membre ; un copropriétaire peut partir si un autre propriétaire reste. Le créateur doit supprimer la salle.

Propriétaire.

Propriétaire.

Propriétaire.

Propriétaire.

Membre ; folderId à null = retour à la racine.

Propriétaire.

Réservé au créateur de chaque salle ; les salles que vous n’avez pas créées comptent comme des échecs.

Ordre du tableau de bord propre à chaque utilisateur.

L’écriture principale. Jusqu’à 100 actions en une requête, appliquées en direct : les participants voient les éléments apparaître. Renvoie `207` avec un résultat par action en cas de réussite partielle. Une création partielle n’est jamais présentée comme une réussite complète.

Rôle editor ou supérieur ; créer ou modifier le contenu du canvas.

Tout le contenu du tableau sous forme de données structurées : éléments avec leur contenu et leurs coordonnées, connecteurs, tâches, sondages et graphiques.

Génération d’une image à partir de texte, directement sur le canvas. Elle utilise les crédits ou la clé du fournisseur du propriétaire du compte : le plafond s’applique par compte, pas par clé.

Génération d’image IA sur le canvas ; consomme des crédits ou utilise votre clé ; idempotent.

Le tableau au format PNG, rendu par un vrai navigateur. Chaque requête utilise une session de navigateur sans interface, d’où un quota spécifique plus strict.

Tableau rendu en image/png (10/min par clé ; 503 si la capture n’est pas configurée)

Les tâches et groupes de tâches de la salle, sans charger tout le canvas.

Renvoie une URL de téléversement signée. Envoyez le fichier avec PUT, puis placez-le sur le tableau via `add_image`, `add_pdf`, `add_video` ou `add_file`, en utilisant l’identifiant renvoyé.

Rôle editor ou supérieur ; renvoie une URL GCS PUT signée. Téléversez un fichier local, puis utilisez add_image avec le gcsMarker.

Rôle editor ou supérieur ; replanification (verrouillage optimiste sur expectedScheduledAt ; notification par e-mail des participants)

Rôle editor ou supérieur.

Écrit dans le chat de la salle au nom du compte, pas d’un bot.

Membre ; écrire un message au nom du compte (30/min par clé)

Exécute le véritable traitement Commit de la salle, identique à celui du produit, en environ une minute. Une personne doit être présente dans la salle pour fournir du contenu à traiter.

Rôle editor ou supérieur ; exécute le traitement Commit réel (~1 min, présence requise dans la salle ; 10/h par compte)

Transforme ces propositions en tâches sur le tableau, attribuées à des personnes.

Rôle editor ou supérieur ; convertir les propositions Commit en tâches (50 maximum)

Propriétaire ; envoyer le dernier compte rendu vers son Slack/Notion (déjà envoyé → {ok, already:true})

Transcription complète et résumé IA d’un enregistrement.

Ajoute un appel au calendrier et envoie un e-mail aux participants. L’action est donc simulée par défaut.

Droit de gestion ; dry_run vaut TRUE par défaut.

Comptes rendus des appels passés, avec les propositions de tâches extraites par Commit. Une proposition dont `tasksApprovedAt` vaut null attend encore une décision.

Chaque résumé contient recapId/callId/report/taskProposals/tasksApprovedAt. Les propositions en attente (tasksApprovedAt à null) peuvent être validées via commit/approve-tasks.

Rôle editor ou supérieur ; modifier un compte rendu enregistré.

Lecture de la mémoire à long terme d’Echo / notes Brain (données sensibles, autorisation explicite)

Rôle editor ou supérieur ; créer une note de mémoire Echo.

Rôle editor ou supérieur ; modifier une note.

Droit de gestion ; suppression logique d’une note.

Renvoie {accepted, received, sent}.

Supprime aussi le lien de contact si la demande a été acceptée.

Dry_run vaut TRUE par défaut ; envoie une invitation réelle à s’inscrire par e-mail.

Droit de gestion ; demandes en attente.

Droit de gestion.

Envoie un vrai e-mail : l’action est **simulée sauf si vous transmettez `dry_run: false`**. La réponse de simulation indique exactement ce qui aurait été envoyé.

Rôle editor ou supérieur ; dry_run vaut TRUE par défaut ; envoie un vrai e-mail.

Renvoie un lien partageable. Aucun e-mail n’est envoyé : il n’y a donc pas de paramètre `dry_run` à gérer.

Droit de gestion ; renvoie un LIEN partageable (sans e-mail)

Les salles contenues sont replacées à la racine.

Propriétaire.

Modèles de salle enregistrés (identifiants à transmettre à POST /rooms)

Une vue transversale : un agent qui demande « quels engagements ai-je pris cette semaine ? » ne devrait pas devoir parcourir chaque salle pour le découvrir.

Toutes les salles : tâches du propriétaire de la clé dans chaque salle dont il est membre (suivi de ses réunions)