Dropbox é uma plataforma popular de armazenamento em nuvem e colaboração que permite a indivíduos e equipes armazenar, acessar e compartilhar arquivos com segurança de qualquer lugar. O Dropbox é projetado para gerenciamento fácil de arquivos, sincronização e colaboração poderosa, seja trabalhando sozinho ou em grupo.
Com o Dropbox no Zoen, você pode:
- Enviar e baixar arquivos: Faça upload de qualquer arquivo para o seu Dropbox ou recupere conteúdo sob demanda
- Listar conteúdo de pastas: Navegue pelos arquivos e pastas em qualquer diretório do Dropbox
- Criar novas pastas: Organize seus arquivos criando novas pastas programaticamente no seu Dropbox
- Pesquisar arquivos e pastas: Localize documentos, imagens ou outros itens por nome ou conteúdo
- Gerar links compartilhados: Crie rapidamente links públicos ou privados compartilháveis para arquivos e pastas
- Gerenciar arquivos: Mova, exclua ou renomeie arquivos e pastas como parte de workflows automatizados
Esses recursos permitem que seus agentes Zoen automatizem operações do Dropbox diretamente nos seus workflows — desde o backup de arquivos importantes até a distribuição de conteúdo e a manutenção de pastas organizadas. Use o Dropbox como origem e destino de arquivos, permitindo o gerenciamento contínuo de armazenamento em nuvem como parte dos seus processos de negócio.
Integrate Dropbox into your workflow for file management, sharing, and collaboration. Upload files, download content, create folders, manage shared links, and more.
Upload a file to Dropbox
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path in Dropbox where the file should be saved (e.g., /folder/document.pdf) |
file | file | No | The file to upload (UserFile object) |
fileContent | string | No | Legacy: base64 encoded file content |
fileName | string | No | Optional filename (used if path is a folder) |
mode | string | No | Write mode: add (default) or overwrite |
autorename | boolean | No | If true, rename the file if there is a conflict |
mute | boolean | No | If true, don't notify the user about this upload |
| Parameter | Type | Description |
|---|
file | object | The uploaded file metadata |
↳ id | string | Unique identifier for the file |
↳ name | string | Name of the file |
↳ path_display | string | Display path of the file |
↳ path_lower | string | Lowercase path of the file |
↳ size | number | Size of the file in bytes |
↳ client_modified | string | Client modification time |
↳ server_modified | string | Server modification time |
↳ rev | string | Revision identifier |
↳ content_hash | string | Content hash for the file |
Download a file from Dropbox with metadata and content
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path of the file to download (e.g., /folder/document.pdf) |
| Parameter | Type | Description |
|---|
file | file | Downloaded file stored in execution files |
metadata | json | The file metadata |
temporaryLink | string | Temporary link to download the file (valid for ~4 hours) |
content | string | Base64 encoded file content (if fetched) |
List the contents of a folder in Dropbox
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path of the folder to list (use "" for root) |
recursive | boolean | No | If true, list contents recursively |
includeDeleted | boolean | No | If true, include deleted files/folders |
includeMediaInfo | boolean | No | If true, include media info for photos/videos |
limit | number | No | Maximum number of results to return (default: 500) |
| Parameter | Type | Description |
|---|
entries | array | List of files and folders in the directory |
↳ id | string | Unique identifier |
↳ name | string | Name of the file/folder |
↳ path_display | string | Display path |
↳ size | number | Size in bytes (files only) |
cursor | string | Cursor for pagination |
hasMore | boolean | Whether there are more results |
Create a new folder in Dropbox
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path where the folder should be created (e.g., /new-folder) |
autorename | boolean | No | If true, rename the folder if there is a conflict |
| Parameter | Type | Description |
|---|
folder | object | The created folder metadata |
↳ id | string | Unique identifier for the folder |
↳ name | string | Name of the folder |
↳ path_display | string | Display path of the folder |
↳ path_lower | string | Lowercase path of the folder |
Delete a file or folder in Dropbox (moves to trash)
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path of the file or folder to delete |
| Parameter | Type | Description |
|---|
metadata | object | Metadata of the deleted item |
↳ name | string | Name of the deleted item |
↳ path_display | string | Display path |
deleted | boolean | Whether the deletion was successful |
Copy a file or folder in Dropbox
| Parameter | Type | Required | Description |
|---|
fromPath | string | Yes | The source path of the file or folder to copy |
toPath | string | Yes | The destination path for the copied file or folder |
autorename | boolean | No | If true, rename the file if there is a conflict at destination |
| Parameter | Type | Description |
|---|
metadata | object | Metadata of the copied item |
↳ id | string | Unique identifier |
↳ name | string | Name of the copied item |
↳ path_display | string | Display path |
↳ size | number | Size in bytes (files only) |
Move or rename a file or folder in Dropbox
| Parameter | Type | Required | Description |
|---|
fromPath | string | Yes | The source path of the file or folder to move |
toPath | string | Yes | The destination path for the moved file or folder |
autorename | boolean | No | If true, rename the file if there is a conflict at destination |
| Parameter | Type | Description |
|---|
metadata | object | Metadata of the moved item |
↳ id | string | Unique identifier |
↳ name | string | Name of the moved item |
↳ path_display | string | Display path |
↳ size | number | Size in bytes (files only) |
Get metadata for a file or folder in Dropbox
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path of the file or folder to get metadata for |
includeMediaInfo | boolean | No | If true, include media info for photos/videos |
includeDeleted | boolean | No | If true, include deleted files in results |
| Parameter | Type | Description |
|---|
metadata | object | Metadata for the file or folder |
↳ id | string | Unique identifier |
↳ name | string | Name of the item |
↳ path_display | string | Display path |
↳ path_lower | string | Lowercase path |
↳ size | number | Size in bytes (files only) |
↳ client_modified | string | Client modification time (files only) |
↳ server_modified | string | Server modification time (files only) |
↳ rev | string | Revision identifier (files only) |
↳ content_hash | string | Content hash (files only) |
Create a shareable link for a file or folder in Dropbox
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path of the file or folder to share |
requestedVisibility | string | No | Visibility: public, team_only, or password |
linkPassword | string | No | Password for the shared link (only if visibility is password) |
expires | string | No | Expiration date in ISO 8601 format (e.g., 2025-12-31T23:59:59Z) |
| Parameter | Type | Description |
|---|
sharedLink | object | The created shared link |
↳ url | string | The shared link URL |
↳ name | string | Name of the shared item |
↳ path_lower | string | Lowercase path of the shared item |
↳ expires | string | Expiration date if set |
↳ link_permissions | object | Permissions for the shared link |
List shared links for a path, or for the entire account if no path is given
| Parameter | Type | Required | Description |
|---|
path | string | No | Path to list shared links for. If omitted, lists all shared links. |
directOnly | boolean | No | If true, only return links directly to the path, not parent folder links |
cursor | string | No | Cursor from a previous call to fetch the next page of results |
| Parameter | Type | Description |
|---|
links | array | Shared links applicable to the path argument |
↳ url | string | The shared link URL |
↳ name | string | Name of the shared item |
↳ path_lower | string | Lowercase path of the shared item |
↳ expires | string | Expiration date if set |
hasMore | boolean | Whether there are more results |
cursor | string | Cursor for pagination (only returned when no path is given) |
Search for files and folders in Dropbox
| Parameter | Type | Required | Description |
|---|
query | string | Yes | The search query |
path | string | No | Dropbox folder path to limit search scope (e.g., /folder/subfolder) |
fileExtensions | string | No | Comma-separated list of file extensions to filter by (e.g., pdf,xlsx) |
maxResults | number | No | Maximum number of results to return (default: 100) |
| Parameter | Type | Description |
|---|
matches | array | Search results |
↳ match_type | object | Type of match: filename, content, or both |
↳ metadata | object | File or folder metadata |
hasMore | boolean | Whether there are more results |
cursor | string | Cursor for pagination |
List the revision history for a file in Dropbox (files only, not folders)
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path of the file to list revisions for |
limit | number | No | Maximum number of revisions to return, 1-100 (default: 10) |
beforeRev | string | No | Only return revisions before this one. Pass the rev of the last revision from a previous call to fetch the next page. |
| Parameter | Type | Description |
|---|
entries | array | The revisions for the file, most recent first |
↳ id | string | Unique identifier for this revision |
↳ name | string | Name of the file |
↳ path_display | string | Display path |
↳ rev | string | Revision identifier, pass to Restore |
↳ size | number | Size of this revision in bytes |
↳ server_modified | string | Server modification time |
isDeleted | boolean | Whether the file identified by the latest revision is deleted or moved |
hasMore | boolean | Whether there are more revisions available |
Restore a specific revision of a file to the given path
| Parameter | Type | Required | Description |
|---|
path | string | Yes | The path to save the restored file to |
rev | string | Yes | The revision identifier to restore (from Dropbox List Revisions) |
| Parameter | Type | Description |
|---|
metadata | object | Metadata of the restored file |
↳ id | string | Unique identifier for the file |
↳ name | string | Name of the file |
↳ path_display | string | Display path of the file |
↳ path_lower | string | Lowercase path of the file |
↳ size | number | Size of the file in bytes |
↳ rev | string | Revision identifier of the restored file |
↳ server_modified | string | Server modification time |