> ## Documentation Index > Fetch the complete documentation index at: https://studio.assembly.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Files > A file, folder, or link shared in the Files App of your portal, belonging to a File Channel. 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](/docs/api-reference/resources/files) **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. ```json Example Folder Object theme={null} { "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" } ``` ```json Example File Object theme={null} { "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" } } ``` ```json Example Link Object theme={null} { "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": "", "lastModifiedBy": { "id": "9640718b-e291-4c93-8366-325235gds", "object": "client" } } ```