dropbox_import_file
Import an original file from the user's connected Dropbox into this project's media library. Use it only when the task needs the media itself (editing, transcription, frames). Pass fileId and expectedRevision from dropbox_list_files or from a file the user attached. Returns assetId; use it like any other media. Importing the same revision again reuses the asset.
Errors: a revision mismatch means the file changed after it was listed; list it again and confirm with the user before using the new version. Keep the project's editor tab open. Not connected or expired: manage_connectors action=connect.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fileId": "<fileId>"
},
"name": "dropbox_import_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fileId | Yes | File ID from the listing or an attached file. | |
| projectId | No | Project for this call (full ID or unambiguous prefix). Explicit-timeline calls never change the target of later calls; legacy project selection applies otherwise. | |
| timelineId | No | ||
| accountTarget | No | Exact account {accountId, revision} from list_connectors. Required on every platform call. | |
| expectedRevision | No | The file revision from that same listing or attachment; the import stops if the file changed. | |
| skipTranscription | No | true when the task does not need speech, such as B-roll or images. Omit it when you will edit by speech or make captions. |