Struct FileView 

pub struct FileView {

    pub file_id: Box<str>,
    pub parent_id: Option<Box<str>>,
    pub root_id: Option<Box<str>>,
    pub owner: Option<ProfileInfo>,
    pub owner_tag: Option<Box<str>>,
    pub creator: Option<ProfileInfo>,
    pub preset: Option<Box<str>>,
    pub content_type: Option<Box<str>>,
    pub file_name: Box<str>,
    pub file_tp: Option<Box<str>>,
    pub created_at: Timestamp,
    pub accessed_at: Option<Timestamp>,
    pub modified_at: Option<Timestamp>,
    pub status: FileStatus,
    pub tags: Option<Vec<Box<str>>>,
    pub visibility: Option<char>,
    pub hidden: bool,
    pub access_level: Option<AccessLevel>,
    pub user_data: Option<FileUserData>,
    pub x: Option<Value>,
    pub parent_name: Option<Box<str>>,
    pub path: Option<Vec<PathSegment>>,
    pub broken_at: Option<Timestamp>,
    pub broken_reason: Option<BrokenReason>,
}

Fields

file_id: Box<str>

parent_id: Option<Box<str>>

root_id: Option<Box<str>>

owner: Option<ProfileInfo>

owner_tag: Option<Box<str>>

Raw files.owner_tag column — None for a locally-owned file.

Not part of the API surface: owner above carries the resolved owner, falling back to the tenant’s own profile when this column is NULL. Consumers that must agree with the stored column rather than the resolved profile — the search indexer, which denormalises it into search_docs.owner_tag — need the raw value.

creator: Option<ProfileInfo>

preset: Option<Box<str>>

content_type: Option<Box<str>>

file_name: Box<str>

file_tp: Option<Box<str>>

created_at: Timestamp

accessed_at: Option<Timestamp>

modified_at: Option<Timestamp>

status: FileStatus

tags: Option<Vec<Box<str>>>

visibility: Option<char>

hidden: bool

LEGACY: read-only flag from pre-managed-folder schema. New writes route system-managed files into parent_id = MANAGED_PARENT_ID instead; the hidden column is preserved only so existing rows from earlier DB versions still list-filter correctly until they are migrated.

access_level: Option<AccessLevel>

user_data: Option<FileUserData>

x: Option<Value>

parent_name: Option<Box<str>>

Immediate parent folder name. Populated only when listing requests withParent=true; None for root, trash, managed-parent, or when not requested. Serialized as parentName and omitted when None.

path: Option<Vec<PathSegment>>

Full path from root → immediate parent (not including the file itself). Populated only when listing requests withPath=true (typically a single-file fetch). Serialized as path and omitted when None.

broken_at: Option<Timestamp>

Tombstone: when set, the source of this cross-context row has issued an authoritative permanent signal (deleted or revoked). Written by POST /api/files/{file_id}/refresh; the frontend calls that endpoint when it detects an inconsistency (broken thumbnail, 404 on blob, stale access). Transient network failures do NOT set this — they surface via the response wrapper’s refreshStatus field instead.

broken_reason: Option<BrokenReason>

Tombstone reason, set together with broken_at. See BrokenReason for the closed set of values.

Trait Implementations

impl Clone for FileView

fn clone(&self) -> FileView

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileView

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileView

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileView

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.