Dropbox GetMetadata

Dropbox GetMetadata

Certified

Retrieve Dropbox item metadata

Retrieves metadata for a Dropbox file or folder. Path must start with / or come from a kestra:// URI.

yaml
type: io.kestra.plugin.dropbox.files.GetMetadata

Get the metadata for a file or folder.

yaml
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"
Properties

Dropbox access token

Token must allow reading the target path.

Path to inspect

Literal Dropbox path or kestra:// URI containing the path. Must start with /.

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.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset 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.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Defaultfalse

Include media info

Default false. When true, requests Dropbox to include photo/video media info in the lookup. Note: media info is not currently exposed in this task's output.

Metadata for the item

Definitions
clientModifiedstring
Formatdate-time

Client modified time

Last modified timestamp from Dropbox. Null for folders.

idstring

Lower-cased path

Dropbox path_lower for the entry — the item's lower-cased path, not a stable unique ID.

namestring

Item name

pathstring

Display path

Case-preserved display path from Dropbox.

sizeinteger

Size in bytes

Null for folders.

typestring

Entry type

Either 'file' or 'folder'.