This resource represents a file object. A file object is a file, folder, or link shared in the Files App of your portal, with the type specified by the object property. Every file object belongs to a File Channel. This API resource describes the metadata of the file object.

To upload or download the contents of a file (as opposed to link or folder), you need to make two API calls. Details are specified in the Create a File and Retrieve a File pages.

Properties

id string The unique identifier for this item.

createdAt string The date this item was created in RFC3339 format.

updatedAt string The date this item was updated in RFC3339 format.

object string The object type of this resource. The file resource can represent either a file, link, or folder.

createdBy string The ID of the user that created this item.

channelId string The ID of the channel this file is assigned to.

downloadUrl string A URL that can be used to download file objects. Field does not appear for folder and link objects. Expires after 15 minutes.

path string The relative location from the channel root for this object. This is a / delimited string where each separated value represents a folder name, until the last value which represents the name of this file resource.

Object	What the last separated value represents
folder	The name of the folder. In the Example Folder Object below, the name of the folder is Test Folder and it is inside another folder named Example.
file	The name of the file including the file extension.
link	The name of the link (i.e. the label of the link in the UI).

clientPermissions string

When the file object is type folder, this will be set to the permissions type for the folder.

Client Permission	Functionality
`read-write` (default)	Clients can view and modify the contents of the folder.
`read-only`	Clients can view, but not modify the contents of the folder.

linkUrl string When the file object is type link, this will be set to the URL the link points to. Otherwise this will be an empty string.

status string When the file object is type file, this can be either pending or completed. This represents the current state of a file being created via the API. If the status is pending, the file has been created via the API but not yet uploaded. Once the file is uploaded, the status will be completed. This field is only present for file objects.

size number Describes the size of the file, in bytes. This field is only present for file objects when performing Retrieve a File

lastModifiedBy object Contains the data of who modified the file last. The object contains:

id string The ID of the user who modified the file.
object string (optional) The object type of the user (one of client, internalUser).

🚧
Deprecation note
We are deprecating the nested fields object and have promoted all of the properties previously contained within the fields object to top-level properties. For backwards compatibility, you may still see the nested fields object in responses and examples.

{
    "channelId": "us-east-1_Gz7TRlAaM/7787061b-21d6-4742-b38d-319f3d18831b/none",
    "createdAt": "2024-02-29T22:34:48.044346124Z",
    "creatorId": "dc0f1749-7d01-48b7-bd80-fcbfce835642",
    "id": "9640718b-e291-4c93-8366-989ae26f58c9",
    "linkUrl": "",
    "name": "Example Folder",
    "object": "folder",
    "path": "Example Folder",
    "lastModifiedBy": {
        "id": "9640718b-e291-4c93-8366-989ae26f58c9",
        "object": "internalUser"
    },
  	"updatedAt": "2024-02-29T22:34:48.044346124Z",
		"clientPermissions": "read-write"

}

{
    "id": "79d08b61-626a-4587-9e2c-b2ab01184a99",
    "object": "file",
    "createdBy": "1dbb3e36-af70-4f41-89e6-6ddf9e2c62b5",
    "createdAt": "2023-03-21T14:22:53.150948433Z",
    "updatedAt": "2023-03-21T14:22:53.150948433Z",
    "channelId": "us-east-1_eq0ubI3tM/c6e79bda-08b0-4654-9d8b-23a4b5ff6e52",
    "downloadUrl": "https://copilot-user-files.s3-accelerate.amazonaws.com/protected/us-east-1%3Aa8c85d0b-f134-4084-9b02-4fea797c36de/files/2023-12-06T17%3A19%3A50.611Z/bigclient3.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIARGA4UFWVEFZ74D5I%2F20231206%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20231206T171959Z&X-Amz-Expires=10800&X-Amz-Security-Token=IQoJb3JpZ2luX2VjECoaCXVzLWVhc3QtMSJGMEQCIGhmJ%2B1Pnuq8zoyJu8nRC1oFBaG0c4U8iL1dWZGZ2JknAiBxPRZc0iUtksBpLxEfgsCytLXyKLWLsxYNWzNxiP%2FPjCqHAwiS%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAIaDDA4MTY2NDQyMTI5MCIMJBHumxEhzXNCyUX2KtsCYQwFNC1kzSWWA%2FYZbyCiHGvN22f6wXCM2OXcsNieK2JwEmVMOEmgiwqc%2B9LVJPRsX5cWqBwnuc8JHh6IPZtfyyOPWk9WBDT8okLvBcqya8YYf%2FjOJwQVpkNGIcy3o%2BInM37KayGPwnG7v0jvSgh7G9ynYpWWSalG43%2BBesBI63d3Fo6FUunzKXh0aFLKBaa3JRd1WJO0sLiXLoTRxB%2BxeX28uACWCkJ8BoWG0v2a%2BGKYk8xqsSlgJb30ZAoaeCzqjxwv6u6pwqjy3W05GgOdzQ3t6p1XhBuWAHexGgL4ooIYAzrydYCtcOpgwqeaUZ%2F%2F2lJ8Zc8kbIS6mDAkiafukQmW0zZCAyvg33JwuBWpgKxNRc6WvOs57ugJgWa2iz5CYoLupL9kYHythYP%2F%2F22nG5%2FqG3GqG%2Bx4IHizDblM5je7UTSKwC9TEFRgclEU9ipPCiljF0gqVA%2BhWPkw2tnCqwY6nwG7wZ7pKfr7O7PJyWRfh2qxAkmoAhTuxaBXZpFH68mFLTAepve6JrWBwiB%2FYA8%2FXHMGcRveVSt61A1xUj2IMllKoX1cXP96wkUxhvo522Bbq%2F%2BJqtmL8hIJQow7M2uO1gPk8ImuRcWxq4uzFn%2FfP1%2FFfMQLuIRrkypXFLrVhQAm3b0TU6OJKNQ8v4cVFEKkuIEQEdwsWFGsQwBqO8mz%2FVg%3D&X-Amz-SignedHeaders=host&X-Amz-Signature=ecdb567a708eed617f3a50376e33635d4935171de3df465616363246646cdb99",
    "name": "Screenshot 2022-08-02 at 16.32.54.png",
    "path": "Example/Test Folder/Screenshot 2022-08-02 at 16.32.54.png",
    "status": "complete",
    "size": 145777,
    "linkUrl": "",
    "lastModifiedBy": {
        "id": "9640718b-e291-4c93-8366-989ae26f58c9",
        "object": "internalUser"
    }
}

{
    "id": "79d08b61-626a-4587-9e2c-b2ab01184a99",
    "object": "link",
    "createdBy": "1dbb3e36-af70-4f41-89e6-6ddf9e2c62b5",
    "createdAt": "2023-03-21T14:22:53.150948433Z",
    "updatedAt": "2023-03-21T14:22:53.150948433Z",
    "channelId": "us-east-1_eq0ubI3tM/c6e79bda-08b0-4654-9d8b-23a4b5ff6e52",
    "name": "Reference Documentation",
    "path": "Example/Test Folder/Reference Documentation",
    "linkUrl": "<https://example.com>",
    "lastModifiedBy": {
        "id": "9640718b-e291-4c93-8366-325235gds",
        "object": "client"
    }
}