Dropbox CreateFolder

Dropbox CreateFolder

Certified

Create folder in Dropbox

Creates a new Dropbox folder at the resolved path. Path must start with /; can be read from a kestra:// URI. Fails on conflicts unless autorename is true (default: false).

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

Create a new folder in Dropbox.

yaml
id: dropbox_create_folder
namespace: company.team
tasks:
  - id: create_folder
    type: io.kestra.plugin.dropbox.files.CreateFolder
    accessToken: "{{ secret('DROPBOX_ACCESS_TOKEN') }}"
    path: "/new_project_folder/sub_folder"
    autorename: false
Properties

Dropbox access token

Token must allow writing to the target path.

Folder path to create

Accepts a literal Dropbox path or a kestra:// URI pointing to a file that contains the path. Resolved 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

Auto-rename on conflict

Default false. When true, Dropbox appends suffixes like (1) if the folder already exists.

Created folder metadata

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