# Apideck.FileStorage
## Class Name
**FileStorageApi**
## Methods
* [Create DriveGroup](#driveGroupsAdd)
* [List DriveGroups](#driveGroupsAll)
* [Delete DriveGroup](#driveGroupsDelete)
* [Get DriveGroup](#driveGroupsOne)
* [Update DriveGroup](#driveGroupsUpdate)
* [Create Drive](#drivesAdd)
* [List Drives](#drivesAll)
* [Delete Drive](#drivesDelete)
* [Get Drive](#drivesOne)
* [Update Drive](#drivesUpdate)
* [List Files](#filesAll)
* [Delete File](#filesDelete)
* [Download File](#filesDownload)
* [Export File](#filesExport)
* [Get File](#filesOne)
* [Search Files](#filesSearch)
* [Rename Or Move File](#filesUpdate)
* [Create Folder](#foldersAdd)
* [Copy Folder](#foldersCopy)
* [Delete Folder](#foldersDelete)
* [Get Folder](#foldersOne)
* [Rename Or Move Folder](#foldersUpdate)
* [Create Shared Link](#sharedLinksAdd)
* [List SharedLinks](#sharedLinksAll)
* [Delete Shared Link](#sharedLinksDelete)
* [Get Shared Link](#sharedLinksOne)
* [Update Shared Link](#sharedLinksUpdate)
* [Start Upload Session](#uploadSessionsAdd)
* [Abort Upload Session](#uploadSessionsDelete)
* [Finish Upload Session](#uploadSessionsFinish)
* [Get Upload Session](#uploadSessionsOne)
# Create DriveGroup
Method: **driveGroupsAdd**
```typescript
fileStorageApi.driveGroupsAdd(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**driveGroup** | [DriveGroup](../models/DriveGroup.md)| |
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
### Response Type
[`CreateDriveGroupResponse`](../models/CreateDriveGroupResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**201** | DriveGroups |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
driveGroup: {
name: 'accounting',
display_name: 'accounting',
description: 'A description',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.driveGroupsAdd(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# List DriveGroups
Method: **driveGroupsAll**
```typescript
fileStorageApi.driveGroupsAll(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**cursor** | [**string**] | Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response. | (optional)
**limit** | [**number**] | Number of results to return. Minimum 1, Maximum 200, Default 20 | (optional) defaults to 20
**filter** | **DriveGroupsFilter** | Apply filters | (optional)
**passThrough** | **PassThroughQuery** | Optional unmapped key/values that will be passed through to downstream as query parameters. Ie: ?pass_through[search]=leads becomes ?search=leads | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetDriveGroupsResponse`](../models/GetDriveGroupsResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | DriveGroups |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {}
try {
const { data } = await apideck.fileStorage.driveGroupsAll(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Delete DriveGroup
Method: **driveGroupsDelete**
```typescript
fileStorageApi.driveGroupsDelete(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`DeleteDriveGroupResponse`](../models/DeleteDriveGroupResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | DriveGroups |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.driveGroupsDelete(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Get DriveGroup
Method: **driveGroupsOne**
```typescript
fileStorageApi.driveGroupsOne(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetDriveGroupResponse`](../models/GetDriveGroupResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | DriveGroups |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.driveGroupsOne(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Update DriveGroup
Method: **driveGroupsUpdate**
```typescript
fileStorageApi.driveGroupsUpdate(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**driveGroup** | [DriveGroup](../models/DriveGroup.md)| |
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`UpdateDriveGroupResponse`](../models/UpdateDriveGroupResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | DriveGroups |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
driveGroup: {
name: 'accounting',
display_name: 'accounting',
description: 'A description',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.driveGroupsUpdate(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Create Drive
Method: **drivesAdd**
```typescript
fileStorageApi.drivesAdd(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**drive** | [Drive](../models/Drive.md)| |
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
### Response Type
[`CreateDriveResponse`](../models/CreateDriveResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**201** | Drives |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
drive: {
name: 'Project Resources',
description: 'A description',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.drivesAdd(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# List Drives
Method: **drivesAll**
```typescript
fileStorageApi.drivesAll(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**cursor** | [**string**] | Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response. | (optional)
**limit** | [**number**] | Number of results to return. Minimum 1, Maximum 200, Default 20 | (optional) defaults to 20
**filter** | **DrivesFilter** | Apply filters | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetDrivesResponse`](../models/GetDrivesResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Drives |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {}
try {
const { data } = await apideck.fileStorage.drivesAll(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Delete Drive
Method: **drivesDelete**
```typescript
fileStorageApi.drivesDelete(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`DeleteDriveResponse`](../models/DeleteDriveResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Drives |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.drivesDelete(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Get Drive
Method: **drivesOne**
```typescript
fileStorageApi.drivesOne(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetDriveResponse`](../models/GetDriveResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Drives |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.drivesOne(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Update Drive
Method: **drivesUpdate**
```typescript
fileStorageApi.drivesUpdate(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**drive** | [Drive](../models/Drive.md)| |
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`UpdateDriveResponse`](../models/UpdateDriveResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Drives |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
drive: {
name: 'Project Resources',
description: 'A description',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.drivesUpdate(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# List Files
Method: **filesAll**
```typescript
fileStorageApi.filesAll(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**cursor** | [**string**] | Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response. | (optional)
**limit** | [**number**] | Number of results to return. Minimum 1, Maximum 200, Default 20 | (optional) defaults to 20
**filter** | **FilesFilter** | Apply filters | (optional)
**sort** | **FilesSort** | Apply sorting | (optional)
**passThrough** | **PassThroughQuery** | Optional unmapped key/values that will be passed through to downstream as query parameters. Ie: ?pass_through[search]=leads becomes ?search=leads | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetFilesResponse`](../models/GetFilesResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Files |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {}
try {
const { data } = await apideck.fileStorage.filesAll(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Delete File
Method: **filesDelete**
```typescript
fileStorageApi.filesDelete(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`DeleteFileResponse`](../models/DeleteFileResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Files |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.filesDelete(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Download File
Method: **filesDownload**
```typescript
fileStorageApi.filesDownload(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
**Blob**
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | File Download |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.filesDownload(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Export File
Method: **filesExport**
```typescript
fileStorageApi.filesExport(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**format** | [**string**] | File format to export this file to. A list of available file formats for the current file is available as `export_formats` on the File resource. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
**Blob**
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | File Download |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
format: 'pdf'
}
try {
const { data } = await apideck.fileStorage.filesExport(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Get File
Method: **filesOne**
```typescript
fileStorageApi.filesOne(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetFileResponse`](../models/GetFileResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | File |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.filesOne(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Search Files
Method: **filesSearch**
```typescript
fileStorageApi.filesSearch(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**filesSearch** | [FilesSearch](../models/FilesSearch.md)| |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**passThrough** | **PassThroughQuery** | Optional unmapped key/values that will be passed through to downstream as query parameters. Ie: ?pass_through[search]=leads becomes ?search=leads | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
**cursor** | [**string**] | Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response. | (optional)
**limit** | [**number**] | Number of results to return. Minimum 1, Maximum 200, Default 20 | (optional) defaults to 20
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**filter** | **FilesFilter** | Apply filters | (optional)
### Response Type
[`GetFilesResponse`](../models/GetFilesResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Files |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
filesSearch: {
query: 'logo jpg'
}
}
try {
const { data } = await apideck.fileStorage.filesSearch(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Rename Or Move File
Method: **filesUpdate**
```typescript
fileStorageApi.filesUpdate(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**file** | [UpdateFileRequest](../models/UpdateFileRequest.md)| |
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`UpdateFileResponse`](../models/UpdateFileResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Files |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
file: {
name: 'New Name.pdf',
description: 'Renamed PDF Document',
parent_folder_id: '1234',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.filesUpdate(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Create Folder
Method: **foldersAdd**
```typescript
fileStorageApi.foldersAdd(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**folder** | [CreateFolderRequest](../models/CreateFolderRequest.md)| |
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`CreateFolderResponse`](../models/CreateFolderResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**201** | Folders |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
folder: {
name: 'Documents',
description: 'My Personal Documents',
parent_folder_id: '1234',
drive_id: '1234',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.foldersAdd(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Copy Folder
Method: **foldersCopy**
```typescript
fileStorageApi.foldersCopy(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**folder** | [CopyFolderRequest](../models/CopyFolderRequest.md)| |
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`UpdateFolderResponse`](../models/UpdateFolderResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Folders |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
folder: {
name: 'Documents',
parent_folder_id: '1234',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.foldersCopy(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Delete Folder
Method: **foldersDelete**
```typescript
fileStorageApi.foldersDelete(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`DeleteFolderResponse`](../models/DeleteFolderResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Folders |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.foldersDelete(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Get Folder
Method: **foldersOne**
```typescript
fileStorageApi.foldersOne(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetFolderResponse`](../models/GetFolderResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Folders |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.foldersOne(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Rename Or Move Folder
Method: **foldersUpdate**
```typescript
fileStorageApi.foldersUpdate(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**folder** | [UpdateFolderRequest](../models/UpdateFolderRequest.md)| |
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`UpdateFolderResponse`](../models/UpdateFolderResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Folders |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
folder: {
name: 'Documents',
description: 'My Personal Documents',
parent_folder_id: '1234',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.foldersUpdate(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Create Shared Link
Method: **sharedLinksAdd**
```typescript
fileStorageApi.sharedLinksAdd(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**sharedLink** | [SharedLink](../models/SharedLink.md)| |
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
### Response Type
[`CreateSharedLinkResponse`](../models/CreateSharedLinkResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**201** | Shared Links |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
sharedLink: {
download_url: 'https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg',
target_id: 'string',
scope: 'company',
password: 'string',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.sharedLinksAdd(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# List SharedLinks
Method: **sharedLinksAll**
```typescript
fileStorageApi.sharedLinksAll(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**cursor** | [**string**] | Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response. | (optional)
**limit** | [**number**] | Number of results to return. Minimum 1, Maximum 200, Default 20 | (optional) defaults to 20
**passThrough** | **PassThroughQuery** | Optional unmapped key/values that will be passed through to downstream as query parameters. Ie: ?pass_through[search]=leads becomes ?search=leads | (optional)
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetSharedLinksResponse`](../models/GetSharedLinksResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Shared Links |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {}
try {
const { data } = await apideck.fileStorage.sharedLinksAll(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Delete Shared Link
Method: **sharedLinksDelete**
```typescript
fileStorageApi.sharedLinksDelete(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`DeleteSharedLinkResponse`](../models/DeleteSharedLinkResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Shared Links |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.sharedLinksDelete(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Get Shared Link
Method: **sharedLinksOne**
```typescript
fileStorageApi.sharedLinksOne(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetSharedLinkResponse`](../models/GetSharedLinkResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Shared Link |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.sharedLinksOne(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Update Shared Link
Method: **sharedLinksUpdate**
```typescript
fileStorageApi.sharedLinksUpdate(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**sharedLink** | [SharedLink](../models/SharedLink.md)| |
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`UpdateSharedLinkResponse`](../models/UpdateSharedLinkResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | Shared Links |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example',
sharedLink: {
download_url: 'https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg',
target_id: 'string',
scope: 'company',
password: 'string',
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.sharedLinksUpdate(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Start Upload Session
Method: **uploadSessionsAdd**
```typescript
fileStorageApi.uploadSessionsAdd(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**uploadSession** | [CreateUploadSessionRequest](../models/CreateUploadSessionRequest.md)| |
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
### Response Type
[`CreateUploadSessionResponse`](../models/CreateUploadSessionResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**201** | UploadSessions |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
uploadSession: {
name: 'Documents',
parent_folder_id: '1234',
drive_id: '1234',
size: 1810673,
pass_through: [
{
service_id: 'string',
operation_id: 'string',
extend_object: {},
extend_paths: [
{
path: '$.nested.property',
value: [Object]
}
]
}
]
}
}
try {
const { data } = await apideck.fileStorage.uploadSessionsAdd(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Abort Upload Session
Method: **uploadSessionsDelete**
```typescript
fileStorageApi.uploadSessionsDelete(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
### Response Type
[`DeleteUploadSessionResponse`](../models/DeleteUploadSessionResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | UploadSessions |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.uploadSessionsDelete(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Finish Upload Session
Method: **uploadSessionsFinish**
```typescript
fileStorageApi.uploadSessionsFinish(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**body** | **object**| |
**id** | [**string**] | ID of the record you are acting upon. |
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**digest** | [**string**] | The RFC3230 message digest of the uploaded part. Only required for the Box connector. More information on the Box API docs [here](https://developer.box.com/reference/put-files-upload-sessions-id/#param-digest) | (optional)
### Response Type
[`GetFileResponse`](../models/GetFileResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**201** | File |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID',
digest: 'REPLACE_WITH_DIGEST'
});
const params = {
id: 'id_example',
uploadSessionsFinish: {}
}
try {
const { data } = await apideck.fileStorage.uploadSessionsFinish(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)
# Get Upload Session
Method: **uploadSessionsOne**
```typescript
fileStorageApi.uploadSessionsOne(body)
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**id** | [**string**] | ID of the record you are acting upon. |
**consumerId** | [**string**] | ID of the consumer which you want to get or push data from | (optional)
**appId** | [**string**] | The ID of your Unify application | (optional)
**serviceId** | [**string**] | Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API. | (optional)
**raw** | [**boolean**] | Include raw response. Mostly used for debugging purposes | (optional) defaults to false
**fields** | [**string**] | The \'fields\' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation.
Example: `fields=name,email,addresses.city`
In the example above, the response will only include the fields \"name\", \"email\" and \"addresses.city\". If any other fields are available, they will be excluded. | (optional)
### Response Type
[`GetUploadSessionResponse`](../models/GetUploadSessionResponse.md)
### HTTP response details
| Status code | Description |
|-------------|-------------|
**200** | UploadSessions |
**400** | Bad Request |
**401** | Unauthorized |
**402** | Payment Required |
**404** | The specified resource was not found |
**422** | Unprocessable |
4/5xx | Unexpected error |
## Example Usage
```typescript
import { Apideck } from '@apideck/node';
const apideck = new Apideck({
apiKey: 'REPLACE_WITH_API_KEY',
appId: 'REPLACE_WITH_APP_ID',
consumerId: 'REPLACE_WITH_CONSUMER_ID'
});
const params = {
id: 'id_example'
}
try {
const { data } = await apideck.fileStorage.uploadSessionsOne(params)
console.log('API called successfully', data)
} catch (error) {
console.error(error)
return error.json()
}
```
[[Back to top]](#) [[Back to API list]](../../../../README.md#documentation-for-api-endpoints) [[Back to README]](../../../../README.md)