# Fiche connecteur Box
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.

## Box
URL : https://get-bruno.com/features/connectors/box
Référence texte : https://get-bruno.com/features/connectors/box/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Stockage de fichiers
Description : Box est une plateforme de gestion de contenu, de collaboration et de partage sécurisé de fichiers. Le catalogue Pipedream expose des actions de consultation, de création, de partage, de téléchargement et des déclencheurs sur les événements de fichiers et de dossiers.
Authentification : OAuth
Présentation : Box est une plateforme de gestion de contenu, de collaboration et de partage sécurisé de fichiers. Le catalogue Pipedream expose des actions de consultation, de création, de partage, de téléchargement et des déclencheurs sur les événements de fichiers et de dossiers.
Usage : Retrouver un fichier client dans Box
Exemple de demande : Je veux retrouver le fichier « compte-rendu client Atelier Martin.pdf » pour préparer sa consultation.
Résultat attendu : Une recherche de fichiers, dossiers ou liens web correspondant aux critères donnés.
À préciser : Nom ou mot-clé, par exemple « compte-rendu client Atelier Martin » ; Éventuel filtre de métadonnées si la recherche doit être précise
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/box/actions/search-content
Usage : Téléverser un fichier de travail dans un dossier Box
Exemple de demande : Je veux envoyer le fichier « catalogue.csv » dans le dossier « Dossiers partagés ».
Résultat attendu : Un téléversement de fichier dans le dossier Box cible.
À préciser : Chemin local ou URL du fichier « catalogue.csv » ; Identifiant du dossier cible, par exemple « Dossiers partagés »
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/box/actions/upload-file
Usage : Créer un dossier pour un projet client
Exemple de demande : Je veux créer le dossier « Projet Atelier Martin » dans Box pour classer les documents.
Résultat attendu : La création d’un dossier vide sous le dossier parent choisi.
À préciser : Nom du dossier « Projet Atelier Martin » ; Identifiant du dossier parent
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/box/actions/create-folder
Limites propres au service : La création d’un dossier impose des règles strictes sur le nom et l’unicité dans le dossier parent. La recherche exige au moins un critère de requête ou de métadonnées. Le téléchargement et l’extraction de texte ont des bornes propres au type et à la taille du fichier.
Vocabulaire français : Ajouter un commentaire — Ajoute un commentaire à un fichier Box. (https://pipedream.com/apps/box/actions/add-comment)
Vocabulaire français : Créer une demande de signature Box Sign — Crée une demande de signature et l’envoie aux signataires listés. (https://pipedream.com/apps/box/actions/create-sign-request)
Vocabulaire français : Créer une collaboration — Donne l’accès à un fichier ou dossier à un utilisateur ou à un groupe avec un rôle. (https://pipedream.com/apps/box/actions/create-collaboration)
Vocabulaire français : Créer un dossier — Crée un nouveau dossier vide dans le dossier parent indiqué. (https://pipedream.com/apps/box/actions/create-folder)
Vocabulaire français : Créer un lien partagé — Crée ou met à jour un lien de partage pour un fichier ou dossier. (https://pipedream.com/apps/box/actions/create-shared-link)
Vocabulaire français : Supprimer une collaboration — Retire l’accès d’un utilisateur ou d’un groupe à un fichier ou dossier. (https://pipedream.com/apps/box/actions/delete-collaboration)
Vocabulaire français : Supprimer un dossier — Envoie un dossier à la corbeille, ou le supprime définitivement selon le paramétrage du compte. (https://pipedream.com/apps/box/actions/delete-folder)
Vocabulaire français : Télécharger un fichier — Télécharge un fichier Box vers le répertoire temporaire du workflow et renvoie son chemin. (https://pipedream.com/apps/box/actions/download-file)
Vocabulaire français : Obtenir les commentaires — Récupère tous les commentaires d’un fichier Box. (https://pipedream.com/apps/box/actions/get-comments)
Vocabulaire français : Obtenir les métadonnées d’un fichier — Récupère les métadonnées d’un fichier, comme le nom, la taille et les dates. (https://pipedream.com/apps/box/actions/get-file-metadata)
Vocabulaire français : Obtenir le texte d’un fichier — Extrait le texte d’un fichier Box à partir de sa représentation textuelle. (https://pipedream.com/apps/box/actions/get-file-text)
Vocabulaire français : Lister les collaborations — Liste les utilisateurs et groupes ayant accès à un fichier ou dossier et leurs rôles. (https://pipedream.com/apps/box/actions/list-collaborations)
Vocabulaire français : Lister les versions d’un fichier — Liste les anciennes versions d’un fichier, hors version courante. (https://pipedream.com/apps/box/actions/list-file-versions)
Vocabulaire français : Lister les éléments d’un dossier — Liste les fichiers, dossiers et liens web contenus dans un dossier Box. (https://pipedream.com/apps/box/actions/list-folder-items)
Vocabulaire français : Lister les dossiers — Liste les sous-dossiers directs d’un dossier Box. (https://pipedream.com/apps/box/actions/list-folders)
Vocabulaire français : Déplacer un dossier — Déplace un dossier vers un autre dossier parent et peut le renommer pendant le déplacement. (https://pipedream.com/apps/box/actions/move-folder)
Vocabulaire français : Rechercher du contenu — Recherche des fichiers, dossiers et liens web dans Box par mot-clé ou filtre de métadonnées. (https://pipedream.com/apps/box/actions/search-content)
Vocabulaire français : Téléverser un fichier — Envoie un fichier dans un dossier Box. (https://pipedream.com/apps/box/actions/upload-file)
Vocabulaire français : Téléverser une nouvelle version d’un fichier — Remplace le contenu d’un fichier Box existant par une nouvelle version. (https://pipedream.com/apps/box/actions/upload-file-version)
Vocabulaire français : Nouvel événement — Déclenche un événement lorsque certains types d’événements se produisent sur un fichier ou dossier ciblé. (https://pipedream.com/apps/box/triggers/new-event)
Vocabulaire français : Nouvel événement de fichier — Déclenche un événement quand un fichier est téléversé dans le dossier ciblé ou déplacé dedans. (https://pipedream.com/apps/box/triggers/new-file)
Vocabulaire français : Nouvel événement de dossier — Déclenche un événement quand un dossier est créé dans le dossier ciblé. (https://pipedream.com/apps/box/triggers/new-folder)
- action : Add Comment — Adds a comment to a Box file. To mention a user, include @[user_id:name] in the message and Box will notify them by email. Use Get Comments to read existing comments on a file. See the documentation. (https://pipedream.com/apps/box/actions/add-comment)
- action : Create Box Sign Request — Creates a Box Sign signature request and sends it to the listed signers. Requires at least one signer, plus the document(s) to sign passed via Additional Options — either source_files (e.g. [{"id": "123456789", "type": "file"}] ) or a template_id ; Box rejects requests with no document source. The signed document and signing log are saved to the Parent Folder . See the documentation. (https://pipedream.com/apps/box/actions/create-sign-request)
- action : Create Collaboration — Adds a collaboration for a user or group on a file or folder, granting them access with a role (editor, viewer, previewer, uploader, previewer uploader, viewer uploader, or co-owner). Item Type must be file or folder . Invite users by email or user ID; groups must be invited by group ID only. Can View Path applies only to folder collaborations. Use Delete Collaboration to revoke access. See the documentation. (https://pipedream.com/apps/box/actions/create-collaboration)
- action : Create Folder — Creates a new empty folder within the specified parent folder. Parent folder ID 0 is the root (All Files). Folder names must be 1-255 characters, use only Unicode Basic Multilingual Plane (BMP) characters, and cannot contain non-printable characters, / or \ , leading or trailing spaces, or be . or .. . Names must be unique within the parent (case-insensitive). Use List Folder Items to inspect contents, or Move Folder / Delete Folder to reorganize afterward. See folder name restrictions. See the documentation. (https://pipedream.com/apps/box/actions/create-folder)
- action : Create Shared Link — Creates or updates a shared link for a file or folder. Access levels: open , company , or collaborators . A password can only be set when access is open ; download permission applies only when access is open or company . A resource can have only one shared link at a time. See the documentation. (https://pipedream.com/apps/box/actions/create-shared-link)
- action : Delete Collaboration — Removes a collaboration, revoking a user's or group's access to a file or folder. Use Create Collaboration to grant access first and obtain a collaboration ID from its response. See the documentation. (https://pipedream.com/apps/box/actions/delete-collaboration)
- action : Delete Folder — Deletes a folder by moving it to trash (or permanently when enterprise settings require). Set Recursive to true to delete non-empty folders and all contents; without it, deleting a non-empty folder fails. Deleting a large folder can take longer than Box's request timeout — Box then returns HTTP 503 while the deletion continues in the background, which this action reports as accepted ( accepted: true ). This cannot be undone from this action — use List Folder Items to verify contents first. See the documentation. (https://pipedream.com/apps/box/actions/delete-folder)
- action : Download File — Downloads a file from Box to your workflow's /tmp directory and returns the saved file path. Use Get File Metadata to check the file's name and size first, or Get File Text to extract text content without downloading. See the documentation (https://pipedream.com/apps/box/actions/download-file)
- action : Get Comments — Fetches all comments on a Box file, paginating through every page and returning the full list. Use Add Comment to create a new comment on the file. See the documentation. (https://pipedream.com/apps/box/actions/get-comments)
- action : Get File Metadata — Retrieves metadata for a file (name, size, timestamps, path, and more). Optionally request specific fields. Use List File Versions for version history, or Download File for content. See the documentation. (https://pipedream.com/apps/box/actions/get-file-metadata)
- action : Get File Text — Extracts the text content of a Box file using its extracted_text representation. Works for office documents, presentations, spreadsheets, PDFs, and plain-text or code files. Box does not generate this representation for images (they have no text layer) or for files larger than 500 MB, and the action fails with an error when the file has no text representation. Use Download File to fetch the raw file instead. See the documentation (https://pipedream.com/apps/box/actions/get-file-text)
- action : List Collaborations — Lists the collaborations (users and groups with access, and their roles) on a Box file or folder. Use this to find a collaboration ID before calling Delete Collaboration , or to audit who has access to an item. Item Type must be file or folder . See the documentation. (https://pipedream.com/apps/box/actions/list-collaborations)
- action : List File Versions — Lists prior versions of a file (does not include the current version). Box only tracks file versions for users with premium accounts, so this returns an empty list on free accounts. Use Get File Metadata for current file details, or Upload File Version to create a new version. See the documentation. (https://pipedream.com/apps/box/actions/list-file-versions)
- action : List Folder Items — Lists files, folders, and web links in a Box folder. Use 0 for the root folder. Returns one page of results (default 100, max 1000). To find items by name or metadata across all folders, use Search Content instead. See the documentation. (https://pipedream.com/apps/box/actions/list-folder-items)
- action : List Folders — Lists the subfolders directly inside a Box folder. Use 0 for the root folder. Returns one page of results (default 100, max 1000). Use List Folder Items instead to also include files and web links. See the documentation. (https://pipedream.com/apps/box/actions/list-folders)
- action : Move Folder — Moves a folder to a new parent folder. Optionally rename the folder while moving. Provide the source folder ID and destination parent folder ID ( 0 for root). Cannot move a folder into itself or one of its descendants. When renaming, the new name must be 1-255 characters, use only Unicode Basic Multilingual Plane (BMP) characters, and cannot contain non-printable characters, / or \ , leading or trailing spaces, or be . or .. . Use Create Folder to create a destination first if needed. See folder name restrictions. See the documentation. (https://pipedream.com/apps/box/actions/move-folder)
- action : Search Content — Searches for files, folders, and web links across the user's Box content by keyword and/or metadata filters — at least one of Query or Metadata Filters is required. Matches item names, descriptions, and file text content; trashed items are excluded. Paginates through and returns all matching results. To browse a known folder instead, use List Folder Items . See the documentation. (https://pipedream.com/apps/box/actions/search-content)
- action : Upload a File — Uploads a file (max 50MB — Box's limit for direct uploads) to a Box folder. The file name must be unique within the parent folder (case-insensitive). Provide either a file URL or a path to a file in the /tmp directory. Use Upload File Version to update an existing file's content instead. See the documentation. (https://pipedream.com/apps/box/actions/upload-file)
- action : Upload File Version — Uploads a new version of an existing Box file (max 50MB), replacing its current content; prior versions are kept in version history on premium accounts. Optionally rename the file at the same time. Use List File Versions to review version history afterward. See the documentation. (https://pipedream.com/apps/box/actions/upload-file-version)
- trigger : New Event — Emit new event when any of the selected event types occurs on the target file or folder, via a Box webhook. See the documentation (https://pipedream.com/apps/box/triggers/new-event)
- trigger : New File Event — Emit new event when a file is uploaded to, or moved into, the target folder ( FILE.UPLOADED ), via a Box webhook. Box fires this trigger for both cases, so moving an existing file into the folder also emits an event. See the documentation (https://pipedream.com/apps/box/triggers/new-file)
- trigger : New Folder Event — Emit new event when a folder is created within the target folder ( FOLDER.CREATED ), via a Box webhook. See the documentation (https://pipedream.com/apps/box/triggers/new-folder)