files

Code
Generates a direct download URL for the given file ID.

Parameters
---------
file_id : str
expires_in : int

Returns
-------
success : bool
    True if successful, false if not
messages : list of str
    List of human-readable error messages
data : dict
    ::
    {
        download_url : str
        file : dict
    }

Code
Generates a presigned S3 POST URL so a caller can upload a file directly
to S3, without BriteCore ever touching the bytes.

Creates a minimal ``File`` row backing the returned ``file_id``, so once
the caller has uploaded, the existing generate_download_url resolves it
unchanged. The minted key always lives under the tenant's own S3 prefix
followed by the enforced ``"uploads/tmp_files/"`` base; ``key_suffix``
may only append a further relative sub-path after that base, never
replace or escape it.

Parameters
----------
content_type : str, required
    The MIME type the uploaded object will be stored with. Also used to
    derive the S3 key's file extension.
key_suffix : str, optional
    A relative sub-path (no leading slash, no ``..`` segments) appended
    after the enforced ``"uploads/tmp_files/"`` base, e.g. ``"carbone/"``
    yields ``"uploads/tmp_files/carbone/"``.
expires_in : int, optional
    Presigned POST TTL in seconds. Defaults to 600; cannot exceed 7 days
    (the AWS SDK's upper limit).
max_size : int, optional
    Maximum allowed upload size in bytes, enforced via the presigned
    POST's content-length-range condition. Defaults to 26214400 (25MB).

Returns
-------
success : bool
    True if successful, false if not
messages : list of str
    List of human-readable error messages
data : dict
    ::
    {
        file_id : str        # the real File.id backing the upload,
                              # usable directly with generate_download_url
        upload_url : str
        upload_fields : dict
        bucket : str
        expires_at : str     # ISO-8601 UTC timestamp
    }

Code
Retrieve a list of active file objects filtered by specified criteria.

This API allows consumers to identify new file objects based on date filters and optionally by label.

Parameters
----------
date_added_from : str, required
    The starting date and time for file addition, format YYYY-mm-dd HH:MM:SS.
date_added_to : str, required
    The ending date and time for file addition, format YYYY-mm-dd HH:MM:SS.
print_date_from : str, required
    The starting print date for files, format YYYY-mm-dd.
print_date_to : str, required
    The ending print date for files, format YYYY-mm-dd.
label : str, optional
    An optional label to further filter the file objects.

Returns
-------
success : bool
    True if the query was successful, False otherwise.
messages : list of str
    List of messages detailing any errors encountered during execution.
data : dict
    A dictionary containing a list of filtered file objects under the key "files".