Create a File
Creates a file, folder, or link record within a file channel. channelID is
required; path is required for folders and linkUrl for links. Files default
to “append” behavior (keep both, adding a numbered suffix) when a file with the
same name already exists at the path.
Authorizations
Path Parameters
The type of file object to be created. This can be 'file', 'folder', or 'link'.
Body
File to create
ChannelID is the file channel the item is created in.
"a8f2c1d4-1234-4abc-9def-0123456789ab"
Type is the kind of item to create. Defaults to "file" when omitted on the path.
file, folder, link "file"
ClientPermissions sets the folder locking permissions for the created file/folder
read_write, read_only "read_write"
DuplicateBehavior specifies how to handle if a file with the same name already exists at the path. Defaults to "append" (keep both) when omitted.
append, replace "append"
FileKey is the S3 object key for an already-uploaded file's binary data.
"files/a8f2c1d4/2024-01-02T15:04:05Z/brochure.pdf"
FileURL is the external link target. Required when creating a link.
"https://example.com/brochure.pdf"
Path is the folder location for the item. Required when creating a folder.
"/contracts/2024"
Response
OK
ChannelID is the file channel the item belongs to.
"a8f2c1d4-1234-4abc-9def-0123456789ab"
ClientPermissions controls client read/write access for folders.
read_write, read_only "read_write"
CreatorId is the id of the user who created the file.
"f4a1b2c3-1234-4abc-9def-0123456789ab"
DownloadURL is a presigned URL for downloading the file's contents.
Fields holds the item's name, path, link target, size, and status.
LastModifiedBy identifies the user who last modified the file.
UpdatedDate is when the file was last updated.
UploadURL is a presigned URL for uploading the file's binary data, set on creation of an unuploaded file.