Dropbox Files GetMetadata
CertifiedRetrieve Dropbox item metadata
Dropbox Files GetMetadata
Retrieve Dropbox item metadata
Retrieves metadata for a Dropbox file or folder. Path must start with / or come from a kestra:// URI.
type: io.kestra.plugin.dropbox.files.GetMetadataExamples
Get the metadata for a file or folder.
id: dropbox_get_metadata
namespace: company.team
tasks:
- id: get_file_metadata
type: io.kestra.plugin.dropbox.files.GetMetadata
accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
path: "/kestra_uploads/my_file.txt"
Get the dimensions and capture time of a photo.
id: dropbox_get_media_info
namespace: company.team
tasks:
- id: get_photo_metadata
type: io.kestra.plugin.dropbox.files.GetMetadata
accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
path: "/photos/example.jpg"
includeMediaInfo: true
- id: log_dimensions
type: io.kestra.plugin.core.log.Log
message: "{{ outputs.get_photo_metadata.file.mediaInfo.width }}x{{ outputs.get_photo_metadata.file.mediaInfo.height }}"
Properties
accessToken *string
Dropbox access token
Token must allow reading the target path.
path *object
Path to inspect
Literal Dropbox path or kestra:// URI containing the path. Must start with /.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150includeMediaInfo booleanstring
falseInclude media info
Default false. When true, photo and video metadata is returned in file.mediaInfo.
Outputs
file
Metadata for the item
io.kestra.plugin.dropbox.models.DropboxFile
date-timeClient modified time
Last modified timestamp from Dropbox. Null for folders.
Lower-cased path
Dropbox path_lower for the entry — the item's lower-cased path, not a stable unique ID.
Media info
Photo or video metadata. Only populated by GetMetadata with includeMediaInfo: true.
io.kestra.plugin.dropbox.models.DropboxMediaInfo
Video duration in milliseconds
Null for photos.
Height in pixels
GPS latitude
GPS longitude
falsePending
True when Dropbox has not finished extracting the media info yet; other fields are then null.
date-timeTime the photo or video was taken
Media type
Either 'photo' or 'video'. Null while Dropbox is still extracting the media info.
Width in pixels
Item name
Display path
Case-preserved display path from Dropbox.
Size in bytes
Null for folders.
Entry type
Either 'file' or 'folder'.
