Skip to main content
Version: 2025.11

File

Description: Represents a file and its associated metadata, revisions, and archive status.

Attributes

NameTypeDescription
idStrictStr
createddatetime.datetime
revisionsList[FileRevision]
archive_status_historyList[FileArchiveStatus]
resource_idOptional[StrictStr]
resource_typeOptional[StrictStr]
created_by_idOptional[StrictStr]
control_tagsOptional[List[ControlTag]]
updatedOptional[datetime.datetime]
upstream_remote_infoOptional[UpstreamRemoteInfo]

Methods

NameDescription
update_propertiesUpdate one or more metadata properties for the latest file revision.
update_descriptionUpdate the file’s description.
update_display_nameUpdate the file’s display name.
update_external_identifierUpdate the file’s external identifier.
update_version_nameUpdate the file’s version name.
to_strReturn the string representation of the model using field aliases.
to_jsonReturn the JSON string representation of the model using field aliases.
from_jsonCreate an instance of the model from a JSON string.
to_dictReturn the dictionary representation of the model using field aliases.
from_dictCreate an instance of the model from a dictionary.
read_bytesRead and return the raw byte contents of the associated file revision.
read_textRead the contents as decoded text.
copy_toCopy the contents to a local file.
read_jsonParse the contents as JSON.
cleanup_cacheClean up cached files if they exist.
get_cache_statsGet filesystem cache statistics.
create_accessCreate a new access relationship for a subject by ID.
create_access_by_emailCreate a new access relationship for a subject by email.
update_accessUpdate an existing access relationship for a subject.
remove_accessRemove an existing access relationship.
list_accessList all access relationships for this resource.
archiveArchive the current item using the client’s archive method for this resource type.
restoreRestore the current item using the client’s restore method for this resource type.