Folders

Resource Schema

Required

Property	Description
path String	File/Folder path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.

Optional

Property	Description
custom_metadata Dynamic	Custom metadata map of keys and values. Limited to 32 keys, 256 characters per key and 1024 characters per value.
provided_mtime String	File last modified date/time, according to the client who set it. Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times. This allows Desktop<->Cloud syncing to preserve modified at times.
priority_color String	Bookmark/priority color of file/folder
mkdir_parents Bool	Create parent directories if they do not exist?

Read Only

Property	Description
created_by_id Int64	User ID of the User who created the file/folder
created_by_api_key_id Int64	ID of the API key that created the file/folder
created_by_as2_incoming_message_id Int64	ID of the AS2 Incoming Message that created the file/folder
created_by_automation_id Int64	ID of the Automation that created the file/folder
created_by_bundle_registration_id Int64	ID of the Bundle Registration that created the file/folder
created_by_inbox_id Int64	ID of the Inbox that created the file/folder
created_by_remote_server_id Int64	ID of the Remote Server that created the file/folder
created_by_sync_id Int64	ID of the Sync that created the file/folder
display_name String	File/Folder display name
type String	Type: `directory` or `file`.
size Int64	File/Folder size
created_at String	File created date/time
last_modified_by_id Int64	User ID of the User who last modified the file/folder
last_modified_by_api_key_id Int64	ID of the API key that last modified the file/folder
last_modified_by_automation_id Int64	ID of the Automation that last modified the file/folder
last_modified_by_bundle_registration_id Int64	ID of the Bundle Registration that last modified the file/folder
last_modified_by_remote_server_id Int64	ID of the Remote Server that last modified the file/folder
last_modified_by_sync_id Int64	ID of the Sync that last modified the file/folder
mtime String	File last modified date/time, according to the server. This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent.
crc32 String	File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
md5 String	File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
sha1 String	File SHA1 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
sha256 String	File SHA256 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
mime_type String	MIME Type. This is determined by the filename extension and is not stored separately internally.
region String	Region location
permissions String	A short string representing the current user's permissions. Can be `r` (Read),`w` (Write),`d` (Delete), `l` (List) or any combination
subfolders_locked? Bool	Are subfolders locked and unable to be modified?
is_locked Bool	Is this folder locked and unable to be modified?
download_uri String	Link to download file. Provided only in response to a download request.
direct_connection_info String	Optional direct connection information for direct Agent transfer attempts
preview_id Int64	File preview ID
preview String	File preview

Example Resource

resource "files_folder" "example_folder" {
  path            = "path"
  mkdir_parents   = false
  provided_mtime  = "2000-01-01T01:00:00Z"
  custom_metadata = {
    key = "value"
  }
  priority_color  = "red"
}

Data Source Schema

Required

Property	Description
path String	File/Folder path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.

Read Only

Property	Description
created_by_id Int64	User ID of the User who created the file/folder
created_by_api_key_id Int64	ID of the API key that created the file/folder
created_by_as2_incoming_message_id Int64	ID of the AS2 Incoming Message that created the file/folder
created_by_automation_id Int64	ID of the Automation that created the file/folder
created_by_bundle_registration_id Int64	ID of the Bundle Registration that created the file/folder
created_by_inbox_id Int64	ID of the Inbox that created the file/folder
created_by_remote_server_id Int64	ID of the Remote Server that created the file/folder
created_by_sync_id Int64	ID of the Sync that created the file/folder
custom_metadata Dynamic	Custom metadata map of keys and values. Limited to 32 keys, 256 characters per key and 1024 characters per value.
display_name String	File/Folder display name
type String	Type: `directory` or `file`.
size Int64	File/Folder size
created_at String	File created date/time
last_modified_by_id Int64	User ID of the User who last modified the file/folder
last_modified_by_api_key_id Int64	ID of the API key that last modified the file/folder
last_modified_by_automation_id Int64	ID of the Automation that last modified the file/folder
last_modified_by_bundle_registration_id Int64	ID of the Bundle Registration that last modified the file/folder
last_modified_by_remote_server_id Int64	ID of the Remote Server that last modified the file/folder
last_modified_by_sync_id Int64	ID of the Sync that last modified the file/folder
mtime String	File last modified date/time, according to the server. This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent.
provided_mtime String	File last modified date/time, according to the client who set it. Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times. This allows Desktop<->Cloud syncing to preserve modified at times.
crc32 String	File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
md5 String	File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
sha1 String	File SHA1 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
sha256 String	File SHA256 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
mime_type String	MIME Type. This is determined by the filename extension and is not stored separately internally.
region String	Region location
permissions String	A short string representing the current user's permissions. Can be `r` (Read),`w` (Write),`d` (Delete), `l` (List) or any combination
subfolders_locked? Bool	Are subfolders locked and unable to be modified?
is_locked Bool	Is this folder locked and unable to be modified?
download_uri String	Link to download file. Provided only in response to a download request.
direct_connection_info String	Optional direct connection information for direct Agent transfer attempts
priority_color String	Bookmark/priority color of file/folder
preview_id Int64	File preview ID
preview String	File preview

Example Data Source

data "files_folder" "example_folder" {
  path = "path"
}