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
| Usage | Fields and validation |
|---|---|
| In requests | View fields |
In requests
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#request
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#field-extensionsSection ID: DOC-API-MODEL-schema-oq26kmqtvq#request-field-extensionsextensions | Array of string | Optional | File extensions used to restrict matching files. |
tags | Array of string | Optional | Labels 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-minsizebytesminSizeBytes | string (int64) | Optional | Minimum 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-maxsizebytesmaxSizeBytes | string (int64) | Optional | Maximum 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-uploadedafteruploadedAfter | string | Optional | Declared 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-uploadedbeforeuploadedBefore | string | Optional | Declared 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-namecontainsnameContains | string | Optional | Text that must occur in the selected file’s name. |
Where used
Section ID: DOC-API-MODEL-schema-oq26kmqtvq#where-used
| Reference | Relationship |
|---|---|
| List files and folders in a directory | POST /api/v1/storage/list-files |
| Search files | POST /api/v1/storage/search-files |
Download the public reference contract.
Document ID: DOC-API-MODEL-schema-oq26kmqtvq