Skip to main content
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#overview

FileFilter

Name, extension, tag and size criteria for selecting stored files. Upload-time fields are accepted but are not applied by the current list and search handlers.

Meaning and usage​

Section ID: DOC-API-MODEL-schema-oq26kmqtvq#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-oq26kmqtvq#fields

UsageFields and validation
In requestsView fields

In requests​

Section ID: DOC-API-MODEL-schema-oq26kmqtvq#request

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-extensionsSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-extensionsextensionsArray of stringOptionalFile extensions used to restrict matching files.
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-tagsSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-tagstagsArray of stringOptionalLabels associated with the resource for organization or filtering.
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-minsizebytesSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-minsizebytesminSizeBytesstring (int64)OptionalMinimum file size included by the filter, in bytes. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-maxsizebytesSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-maxsizebytesmaxSizeBytesstring (int64)OptionalMaximum file size included by the filter, in bytes. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-uploadedafterSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-uploadedafteruploadedAfterstringOptionalDeclared lower upload-time bound. The current list-files and search-files handlers accept this field but do not apply it. Do not rely on it to exclude files by date; inspect returned timestamps and the operation’s result limits.
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-uploadedbeforeSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-uploadedbeforeuploadedBeforestringOptionalDeclared upper upload-time bound. The current list-files and search-files handlers accept this field but do not apply it. Do not rely on it to exclude files by date; inspect returned timestamps and the operation’s result limits.
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-namecontainsSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-namecontainsnameContainsstringOptionalText that must occur in the selected file’s name.

Where used​

Section ID: DOC-API-MODEL-schema-oq26kmqtvq#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 ID: DOC-API-MODEL-schema-oq26kmqtvq