> For the complete documentation index, see [llms.txt](https://t1t.gitbook.io/t1c-js-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://t1t.gitbook.io/t1c-js-guide/containers/other/file-exchange.md).
# File Exchange
## Introduction
The File Exchange container allows Trust1Connector to upload or download files from the filesystem to the requesting party. In order to be able to access the file system, a separate `file_exchange` consent is required.
The File Exchange container provides the following functionalities:
* selecting a folder to use (using system folder selection mechanism)
* listing files in selected folder
* downloading a provided file into selected folder
* uploading a file from the selected folder
## Available Functions
The following functions are available in the T1C-JS library:
| JavaScript API |
| -------------- |
| Function | Input | Output | Description |
| ------------ | ---------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| downloadFile | path, file, fileName | N/A | Creates a file named `fileName` at the `path` location, with file contents `file` |
| listFiles | `{ path, extensions }` | list of files in directory | Returns a list of all files in the `path` directory that have an extension included in the `extensions` array |
| setFolder | N/A | path of selected directory | Triggers a system file selection dialog that allows the user to select a directory. The selected directory is returned as the response |
| uploadFile | path | fileBuffer | Will retrieve the file located at `path` and return it as a fileBuffer |
## Detailed Function Overview
### downloadFile
Downloads a provided file(Buffer) into the provided directory.
#### Interface
```javascript
downloadFile(path: string, file: ArrayBuffer, fileName: string)
```
#### Parameters
* **path**: location for the newly created file
* **file**: ArrayBuffer containing binary data to be put in the file
* **fileName**: name to be given to the file
#### Output
```javascript
{
data: string // absolute path of the newly created file
success: boolean
}
```
### listFiles
Returns a list of files in the selected directory.
#### Interface
`listFiles({ path: string, extensions: string[] }, callback: (error, data))`
#### Parameters
* **dataObject** containing two config parameters:
* **path**: directory to list
* **extensions**: array of file extensions to be included in the list
#### Output
```javascript
{
data: [{
extension: string,
last_modification_time: string,
name: string,
path: string,
size: number
}],
success: boolean
}
```
### setFolder
Triggers system dialog to select a folder
#### Interface
`setFolder(callback?: (error, data))`
#### Parameters
* none
#### Output
```javascript
{
data: string // path of the selected folder
success: boolean
}
```
### uploadFile
Uploads the file located at `path` to the requesting user.
#### Interface
`uploadFile(path: string)`
#### Parameters
* **feature**: absolute path to the requested file
#### Output
```javascript
fileBuffer
```