Data Types

ListFolderParams

Parameter object passed to the ListFolder method in the Bytescale SDKs.

{
"accountId": String,
"cursor": String,
"dryRun": Boolean,
"folderPath": String,
"includeFiles": Boolean,
"limit": Integer,
"recursive": Boolean
}
{
"accountId": "YOUR_ACCOUNT_ID",
"cursor": "aGVsbG8=",
"dryRun": true,
"folderPath": "/uploads",
"includeFiles": true,
"includeOverriddenStorage": true,
"includePhysicalFolders": true,
"includeVirtualFolders": true,
"limit": 50,
"recursive": true
}

Your account ID.

This is visible on the settings page:

https://www.bytescale.com/dashboard/settings

Example: "A623uY2"

Type: String

Length: 7

Required: No

Pagination cursor. This is used to fetch subsequent pages of results from large folders.

To fetch the next page of results, you must set this to the value of the cursor field from the previous ListFolderResponse.

Pagination is complete when ListFolderResponse contains isPaginationComplete=true.

Example: "aGVsbG8="

Type: String

Required: No

This parameter allows you to simulate a CopyFolder or DeleteFolder operation without performing the operation.

When set to true this operation will return the same set of items that would be operated on by the CopyFolder and DeleteFolder operations, assuming you provide the same folderPath and include* parameters to this operation as you do to the CopyFolder and DeleteFolder operations.

Default: false

Type: Boolean

Required: No

Absolute path to a folder. Begins with a /. Should not end with a /.

Example: "/uploads"

Type: String

Min Length: 1

Max Length: 512

Required: No

If true then files will be included in the result.

Default: true

Type: Boolean

Required: No

If true then includes files from folders that have overridden storage settings, else skips them.

If the current folder inherits its storage settings from an ancestor folder that has overridden storage settings, then files from the current folder will be included in this operation, regardless of this flag.

You can ignore this setting if your account does not use folders with overridden storage settings (e.g. custom AWS S3 buckets).

Default: true

Type: Boolean

Required: No

If true then folders automatically created as a result of files being uploaded to them will be included.

This field is automatically set to false when recursive=true.

Default: true

Type: Boolean

Required: No

If true then folders explicitly created using PutFolder will be included.

Default: true

Type: Boolean

Required: No

The maximum number of items to return.

The response might contain fewer items but will never contain more.

This limit is applied on the unfiltered result, which means the response may contain fewer items than the limit even when there are more items to return. This will occur only when one or more include* flags are set to false.

Example: 50

Type: Integer

Minimum: 1

Maximum: 1000

Required: No

If true then iterates sub-folders recursively.

Default: false

Type: Boolean

Required: No

Was this section helpful? Yes No

You are using an outdated browser.

This website requires a modern web browser -- the latest versions of these browsers are supported: