Skip to main content

FileFilter

Name, extension, tag, size, and upload-time criteria selecting stored files.

Usage profiles​

UsageFields and validation
In requestsView fields

In requests​

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
extensionsArray of stringOptionalFile extensions used to restrict matching files.
tagsArray of stringOptionalLabels associated with the resource for organization or filtering.
minSizeBytesstring (int64)OptionalMinimum file size included by the filter, in bytes. Pattern: ^-?\d+$.
maxSizeBytesstring (int64)OptionalMaximum file size included by the filter, in bytes. Pattern: ^-?\d+$.
uploadedAfterstringOptionalLower timestamp bound for files selected by upload time.
uploadedBeforestringOptionalUpper timestamp bound for files selected by upload time.
nameContainsstringOptionalText that must occur in the selected file’s name.

Where used​

ReferenceRelationship
List files and folders in a directoryPOST /api/v1/storage/list-files
Search filesPOST /api/v1/storage/search-files

Download the public reference contract.

Document: DOC-API-MODEL-file-filter.