# Fiche connecteur Excalidraw
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Excalidraw
URL : https://get-bruno.com/features/connectors/excalidraw
Référence texte : https://get-bruno.com/features/connectors/excalidraw/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Organisation du travail
Description : Excalidraw est un tableau blanc collaboratif pour gérer des espaces de dessin, appelés scènes, dans Excalidraw Plus. Le service sert à créer, organiser, consulter et mettre à jour ces scènes dans des collections.
Authentification : API key
Présentation : Excalidraw est un tableau blanc collaboratif pour gérer des espaces de dessin, appelés scènes, dans Excalidraw Plus. Le service sert à créer, organiser, consulter et mettre à jour ces scènes dans des collections.
Usage : Créer une scène dans un dossier précis
Exemple de demande : Je veux créer une scène nommée Compte-rendu atelier dans la collection Atelier Martin.
Résultat attendu : Une nouvelle scène est créée dans la collection indiquée, avec son identifiant et ses métadonnées.
À préciser : Nom de la scène souhaitée ; Nom ou identifiant de la collection cible ; Objectif de rangement de la scène
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/excalidraw/actions/create-scene ; https://pipedream.com/apps/excalidraw/actions/list-collections
Usage : Retrouver une scène par son nom
Exemple de demande : Je veux retrouver la scène Schéma réseau client pour vérifier où elle est rangée.
Résultat attendu : Une liste de scènes correspondantes est renvoyée, avec filtre éventuel par collection.
À préciser : Nom partiel ou exact de la scène ; Nom de la collection si la scène doit être cherchée dans un dossier précis
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/excalidraw/actions/list-scenes ; https://pipedream.com/apps/excalidraw/actions/list-collections
Usage : Consulter le contenu d’une scène
Exemple de demande : Je veux lire la scène Prototype produit pour voir ses métadonnées et son contenu de dessin.
Résultat attendu : Les métadonnées de la scène sont renvoyées, avec le contenu complet du dessin si demandé.
À préciser : Nom ou identifiant de la scène ; Besoin explicite du contenu de dessin si le détail est nécessaire
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/excalidraw/actions/get-scene ; https://pipedream.com/apps/excalidraw/actions/list-scenes
Limites propres au service : Aucune recherche serveur par nom dans les scènes; le filtre est appliqué côté client. La description d’une scène n’est pas prise en charge par l’API. La suppression d’une scène est définitive. Le contenu complet d’une scène peut être volumineux.
Vocabulaire français : Créer une collection — Crée un dossier de rangement dans l’espace Excalidraw Plus et renvoie son identifiant. (https://pipedream.com/apps/excalidraw/actions/create-collection)
Vocabulaire français : Créer une scène — Crée un tableau blanc dans une collection donnée, ou dans la collection principale si aucune collection n’est fournie. (https://pipedream.com/apps/excalidraw/actions/create-scene)
Vocabulaire français : Supprimer une scène — Supprime définitivement une scène Excalidraw et tout son contenu de dessin. (https://pipedream.com/apps/excalidraw/actions/delete-scene)
Vocabulaire français : Obtenir l’utilisateur courant — Renvoie le contexte de l’espace de travail courant, avec l’identifiant de l’espace, les noms et les rôles. (https://pipedream.com/apps/excalidraw/actions/get-current-user)
Vocabulaire français : Obtenir une scène — Renvoie les métadonnées d’une scène et, si demandé, son contenu complet de dessin. (https://pipedream.com/apps/excalidraw/actions/get-scene)
Vocabulaire français : Lister les collections — Renvoie les collections disponibles pour retrouver leurs identifiants et leurs noms. (https://pipedream.com/apps/excalidraw/actions/list-collections)
Vocabulaire français : Lister les scènes — Renvoie les scènes de l’espace, avec filtre éventuel par collection ou par sous-chaîne de nom. (https://pipedream.com/apps/excalidraw/actions/list-scenes)
Vocabulaire français : Mettre à jour une scène — Met à jour le nom d’une scène ou son appartenance à une collection. (https://pipedream.com/apps/excalidraw/actions/update-scene)
- action : Create Collection — Creates a new collection (folder) in the Excalidraw Plus workspace for organizing scenes. Returns the new collection's ID — pass it to Create Scene or Update Scene to add scenes to this collection. See the documentation (https://pipedream.com/apps/excalidraw/actions/create-collection)
- action : Create Scene — Creates a new scene (whiteboard) in the Excalidraw Plus workspace. The API requires a collection — if no collectionId is provided, the scene is placed in the default (Main) collection automatically. Use List Collections to find the collection ID if the user wants the scene in a specific folder. Returns the new scene's ID and metadata. See the documentation (https://pipedream.com/apps/excalidraw/actions/create-scene)
- action : Delete Scene — Permanently deletes an Excalidraw scene and all its drawing content. This action cannot be undone. Use List Scenes to find the scene ID before calling this tool. See the documentation (https://pipedream.com/apps/excalidraw/actions/delete-scene)
- action : Get Current User — Returns the current workspace context from Excalidraw Plus, including workspace ID, name, user IDs, and roles. Use this when the user asks 'who am I', 'what workspace am I in', or needs the workspace ID or user role. See the documentation (https://pipedream.com/apps/excalidraw/actions/get-current-user)
- action : Get Scene — Returns metadata for a specific Excalidraw scene, and optionally its full drawing content (elements JSON). Use this when the user asks to view, inspect, or read a specific scene. Use List Scenes first to find the scene ID by name. Set includeContent to true only when the user explicitly asks for the drawing data — the content can be large. See the documentation (https://pipedream.com/apps/excalidraw/actions/get-scene)
- action : List Collections — Returns all collections (folders) in the Excalidraw Plus workspace. Use this to discover available collection IDs and names before filtering scenes by collection or creating a scene in a specific collection. Cross-reference: pass a collection ID from this result to List Scenes or Create Scene . See the documentation (https://pipedream.com/apps/excalidraw/actions/list-collections)
- action : List Scenes — Returns scenes (whiteboards) in the Excalidraw Plus workspace. Optionally filter by collection ID or apply a name substring filter (applied client-side, since the API has no server-side search). When the user says 'scenes in [collection]', use List Collections first to get the collection ID, then pass it as collectionId here. Use nameFilter (and limit ) to narrow results when the user asks for a scene by name — the tool fetches up to limit scenes and returns only those whose name contains the filter string. See the documentation (https://pipedream.com/apps/excalidraw/actions/list-scenes)
- action : Update Scene — Updates an existing Excalidraw scene's name or collection membership. Use List Scenes to find the scene ID, and List Collections to find a collection ID if moving the scene. Only the fields you provide are updated — omitted fields remain unchanged. Note: the Excalidraw API does not support a description field on scenes. See the documentation (https://pipedream.com/apps/excalidraw/actions/update-scene)