Box Connector Reference 5.3 | MuleSoft Documentation
# Box Connector Reference 5.3
Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.  
---  
Anypoint Connector for Box (Box Connector) provides access to the Box Content API for secure content management and content experience features for use in your own app. The connector is RESTful and is organized around the main resources you’re familiar with from the Box web interface.
## Configurations
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Name for this configuration. Connectors reference the configuration with this name.  
Connection | 
  * Oauth2security Connection Provider

| Connection types to provide to this configuration.  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
The identifier of this element used to reference it in other components  
Expiration Policy |  Expiration Policy | Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances as appropriate.  
#### Connection Types
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Default Headers |  Array of Default Header  
Query Parameters |  Array of Default Query Param  
Connection Timeout | The timeout for establishing connections to the remote service  
Connection Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit which qualifies the **Connection Timeout**.  
Use Persistent Connections | If false, each connection will be closed after the first request is completed.  
Max Connections | The maximum number of outbound connections that will be kept open at the same time  
Connection Idle Timeout | A timeout for how long a connection can remain idle before it is closed  
Connection Idle Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the connection **Idle Timeout**.  
Proxy Config | Reusable configuration element for outbound connections through a proxy  
Stream Response | Whether or not received responses should be streamed  
Response Buffer Size | The space in bytes for the buffer where the HTTP response will be stored.  
Client Secret  
Public Key Id | ID of the Public Key configured in your Box instance to authenticate the application.  
Entity Id | The type of the Entity ID: EnterpriseId or UserId  
Box Sub Type |  Enumeration, one of:
  * ENTERPRISE

| The box sub type: enterprise or user  
Algorithm |  Enumeration, one of:
  * RS256
  * RS384
  * RS512

| The RSA encryption algorithm used to encrypt the private key.  
Keystore | Path to keystore  
Keystore Type | Keystore type: JKS, PKCS12, BCFKS, etc.  
Store Password | Password of key store  
Key Alias | Alias which identifies the key  
Key Password | Key password  
Reconnection |  | When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn’t pass after exhausting the associated reconnection strategy  
##### Oauth2security Connection Provider
Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more information, refer to Configuring OAuth 2.0 for Connectors or Configuring OAuth 2.0 for Connectors on CloudHub.
###### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Default Headers |  Array of Default Header  
Query Parameters |  Array of Default Query Param  
Connection Timeout | The timeout for establishing connections to the remote service  
Connection Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit which qualifies the **Connection Timeout**.  
Use Persistent Connections | If false, each connection is closed after the first request is completed.  
Max Connections | Maximum number of outbound connections to keep open concurrently.  
Connection Idle Timeout | A timeout for how long a connection can remain idle before it is closed.  
Connection Idle Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit which qualifies the connection **Idle Timeout**.  
Proxy Config | Reusable configuration element for outbound connections through a proxy.  
Stream Response | Whether or not to stream received responses.  
Response Buffer Size | The space in bytes for the buffer where the HTTP response is stored.  
Protocol |  Enumeration, one of: | Protocol to use for communication. Valid values are HTTP and HTTPS.  
TLS Configuration  
Reconnection |  | When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
Consumer Key | The OAuth consumerKey, as registered with the service provider.  
Consumer Secret | The OAuth consumerSecret, as registered with the service provider.  
Authorization Url | Service provider’s authorization endpoint URL | `https://account.box.com/api/oauth2/authorize`  
Access Token Url | The service provider’s accessToken endpoint URL | `https://api.box.com/oauth2/token`  
The OAuth scopes to request during the OAuth dance. If not provided, the values default to those in the annotation. | 
  * root_readwrite
  * manage_app_users
  * manage_managed_users
  * manage_groups
  * manage_webhook
| Time unit which qualifies the connection **Idle Timeout**.  
Proxy Config | Reusable configuration element for outbound connections through a proxy.  
Stream Response | Whether or not to stream received responses.  
Response Buffer Size | The space in bytes for the buffer where the HTTP response is stored.  
Protocol |  Enumeration, one of: | Protocol to use for communication. Valid values are HTTP and HTTPS.  
TLS Configuration  
Reconnection |  | When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
Consumer Key | The OAuth consumerKey, as registered with the service provider.  
Consumer Secret | The OAuth consumerSecret, as registered with the service provider.  
Authorization Url | Service provider’s authorization endpoint URL | `https://account.box.com/api/oauth2/authorize`  
Access Token Url | The service provider’s accessToken endpoint URL | `https://api.box.com/oauth2/token`  
The OAuth scopes to request during the OAuth dance. If not provided, the values default to those in the annotation. | 
  * root_readwrite
  * manage_app_users
  * manage_managed_users
  * manage_groups
  * manage_webhook

  
Resource Owner Id | Resource owner ID each component should use if the resource owner ID is not otherwise referenced.  
The name of a flow to execute immediately before starting the OAuth dance.  
The name of a flow to execute immediately after an access token is received.  
Listener Config | A reference to an `<http:listener-config />` to use to create the listener that will receive the access token callback endpoint.  
Callback Path | The path of the access token callback endpoint  
Authorize Path | The path of the local http endpoint which triggers the OAuth dance  
External Callback Url | If the callback endpoint is behind a proxy or should be accessed through a non direct URL, use this parameter to tell the OAuth provider the URL it should use to access the callback  
Object Store | A reference to the object store to use to store each resource owner ID’s data. If not specified, Mule automatically provisions the default object store.  
## Associated Operations
  * Add domain to list of allowed collaboration domains
  * Create user exemption from collaboration domain restrictions
  * Create collaboration
  *   *   *   *   * Upload file version
  * Create metadata instance on file
  * Add classification to file
  * Create Box Skill cards on file
  * Create upload session
  * Create upload session for existing file
  * Commit upload session
  * Revert file version
  * Create folder lock on folder
  *   *   *   * Create metadata instance on folder
  * Add classification to folder
  * Add user to group
  *   * Create user invite
  * Create legal hold policy
  * Assign legal hold policy
  * Create metadata cascade policy
  * Force-apply metadata cascade policy to folder
  * Query files and folders by metadata
  * Create metadata template
  * Add initial classifications
  * Create retention policy
  * Assign retention policy
  * Assign storage policy
  *   *   * Create terms of service status for new user
  * Create terms of service
  *   * Create email alias
  * Create web link
  *   *   * Create zip download
  * Remove domain from list of allowed collaboration domains
  * Remove user from list of users exempt from domain restrictions
  * Remove collaboration
  *   *   * Delete file request
  *   * Remove metadata instance from file
  * Remove classification from file
  * Remove Box Skill cards from file
  * Permanently remove file
  * Remove upload session
  * Remove file version
  * Remove watermark from file
  * Delete folder lock
  *   * Remove metadata instance from folder
  * Remove classification from folder
  * Permanently remove folder
  * Remove watermark from folder
  * Remove user from group
  *   * Remove legal hold policy
  * Unassign legal hold policy
  * Remove metadata cascade policy
  * Delete all classifications
  * Remove metadata template
  * Unassign storage policy
  *   *   *   *   *   * Permanently remove web link
  *   * List allowed collaboration domains
  * Get allowed collaboration domain
  * List users exempt from collaboration domain restrictions
  * Get user exempt from collaboration domain restrictions
  * List pending collaborations
  *   * List all collections
  * List collection items
  *   *   * List enterprise device pins
  * List user and enterprise events
  *   * List file version legal holds
  * Get file version legal hold
  * List file version retentions
  * Get retention on file
  * Get file information
  * List file collaborations
  * List file comments
  *   * Get shared link for file
  * List metadata instances on file
  * Get metadata instance on file
  * Get classification on file
  * List Box Skill cards on file
  * List tasks on file
  * Get file thumbnail
  * Get trashed file
  *   * List all file versions
  *   * Get watermark on file
  * List folder locks on folder
  * Get folder information
  * List folder collaborations
  * Get shared link for folder
  * List items in folder
  * List metadata instances on folder
  * Get metadata instance on folder
  * Get classification on folder
  * Get trashed folder
  * List trashed items
  * Get watermark for folder
  * Get group membership
  * List groups for enterprise
  * List collaborations for group
  * List members of group
  * Get user invite status
  * List all legal hold policies
  * Get legal hold policy
  * List legal hold policy assignments
  * Get legal hold policy assignment
  * List previous file versions for legal hold policy assignment
  * List current file versions for legal hold policy assignment
  * List metadata cascade policies
  * Get metadata cascade policy
  * Find metadata template by instance ID
  * Get metadata template by ID
  * List all metadata templates for enterprise
  * List all classifications
  * List all global metadata templates
  * Get metadata template by name
  * Get events long poll endpoint
  * Preflight check before upload
  * List recently accessed items
  * List retention policies
  * List retention policy assignments
  * Get retention policy
  * Get retention policy assignment
  * Search for content
  * Find file for shared link
  * Find folder for shared link
  * List storage policies
  *   * List storage policy assignments
  * Get storage policy assignment
  * Get task assignment
  * List task assignments
  * List terms of service user statuses
  * List terms of services
  * Get terms of service
  * List enterprise users
  *   * List user’s email aliases
  * Get current user
  * List user’s groups
  *   * Get trashed web link
  * List all webhooks
  *   * Download zip archive
  * Get zip download status
  *   * PUpdate collaboration
  *   * Update file request
  * Add shared link to file
  *   * Update metadata instance on file
  * Update classification on file
  * Update Box Skill cards on file
  * Remove shared link from file
  * Update shared link on file
  *   * Apply watermark to file
  * Add shared link to folder
  *   * Update metadata instance on folder
  * Update classification on folder
  * Remove shared link from folder
  * Update shared link on folder
  * Apply watermark to folder
  * Update group membership
  *   * Update legal hold policy
  *   *   *   * Update metadata template
  * Update retention policy
  * Update all Box Skill cards on file
  * Update storage policy assignment
  * Update task assignment
  *   * Update terms of service status for existing user
  * Update terms of service
  *   * Transfer owned folders
  *   * 

## Associated Sources
  * On Download File Trigger
  * On New File in Folder
  *   * On New Task Created


## Add domain to list of allowed collaboration domains
`<box:create-collaboration-whitelist-entries>`
Creates a new entry in the list of domains allowed to collaborate. This operation makes an HTTP POST request to the /collaboration_whitelist_entries endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
## Associated Sources
  * On Download File Trigger
  * On New File in Folder
  *   * On New Task Created


## Add domain to list of allowed collaboration domains
`<box:create-collaboration-whitelist-entries>`
Creates a new entry in the list of domains allowed to collaborate. This operation makes an HTTP POST request to the /collaboration_whitelist_entries endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create user exemption from collaboration domain restrictions
`<box:create-collaboration-whitelist-exempt-targets>`
Exempts a user from the restrictions set out by the allowed list of domains for collaborations. This operation makes an HTTP POST request to the /collaboration_whitelist_exempt_targets endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create collaboration
`<box:create-collaborations>`
Adds a collaboration for a single user or a single group to a file or folder. Collaborations can be created using email address, user IDs, or a group IDs. If a collaboration is being created with a group, access to this endpoint is dependent on the group’s ability to be invited. This operation makes an HTTP POST request to the /collaborations endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
Determines if users should receive email notification for the action performed.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create comment
`<box:create-comments>`
Adds a comment by the user to a specific file, or as a reply to an other comment. This operation makes an HTTP POST request to the /comments endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  *
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Copy file request
`<box:create-file-requests-copy-by-file-request-id>`
Copies an existing file request that is present on one folder, and applies it to another folder. This operation makes an HTTP POST request to the /file_requests/{file_request_id}/copy endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
File request id | The unique identifier that represents a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/filerequest/123` the `file_request_id` is `123`.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | The name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | Timeout for the request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Restore file
`<box:create-files-by-file-id>`
Restores a file that was moved to the trash. An optional new parent ID can be provided to restore the file to in case the original folder has been deleted. This operation makes an HTTP POST request to the /files/{file_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Upload file
`<box:create-files-content>`
Uploads a small file to Box. For file sizes over 50MB, use the Chunk Upload APIs.
In the Request body, the `attributes` part of the body must come **before** the `file` part. Requests that do not follow this format when uploading the file will receive an HTTP `400` error with a `metadata_after_file_contents` error code.
This operation makes an HTTP POST request to the /files/content endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
Content md5 | An optional header containing the SHA1 hash of the file to ensure that the file was not corrupted in transit.  
Attributes - Body | The content of the 'attributes' part. | #[payload]  
File - Body | The content of the 'file' part.  
file Filename | The filename of the 'file' part (just the name, do not include path).  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Upload file version
`<box:create-files-content-by-file-id>`
Updates a file’s content. For file sizes over 50MB, use the Chunk Upload APIs.
For the Request body order, the `attributes` part of the body must come **before** the `file` part. Requests that do not follow this format when uploading the file will receive an HTTP `400` error with a `metadata_after_file_contents` error code.
This operation makes an HTTP POST request to the /files/{file_id}/content endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
If match | Ensures this item hasn’t recently changed before making changes. Pass in the item’s last observed `etag` value into this header and the endpoint will fail with a `412 Precondition Failed` if it has changed since.  
Content md5 | An optional header containing the SHA1 hash of the file to ensure that the file was not corrupted in transit.  
Attributes - Body | The content of the 'attributes' part. | #[payload]  
File - Body | The content of the 'file' part.  
file Filename | The filename of the 'file' part. Do not include the path; use only the file name.  
Config Ref |  ConfigurationProvider | The name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Copy file
`<box:create-files-copy-by-file-id>`
Creates a copy of a file. This operation makes an HTTP POST request to the /files/{file_id}/copy endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create metadata instance on file
`<box:create-files-metadata-by-file-id-scope-template-key>`
Applies an instance of a metadata template to a file. In most cases only values that are present in the metadata template will be accepted, with the exception of the `global.properties` template, which accepts any key-value pair.
This operation makes an HTTP POST request to the /files/{file_id}/metadata/{scope}/{template_key} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Enumeration, one of:
  * GLOBAL
  * ENTERPRISE

| The scope of the metadata template  
Template key | The name of the metadata template  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream
## Create metadata instance on file
`<box:create-files-metadata-by-file-id-scope-template-key>`
Applies an instance of a metadata template to a file. In most cases only values that are present in the metadata template will be accepted, with the exception of the `global.properties` template, which accepts any key-value pair.
This operation makes an HTTP POST request to the /files/{file_id}/metadata/{scope}/{template_key} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Enumeration, one of:
  * GLOBAL
  * ENTERPRISE

| The scope of the metadata template  
Template key | The name of the metadata template  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Add classification to file
`<box:create-files-metadata-enterprise-security-classification6vmvochw-uwo-by-file-id>`
Adds a classification to a file by specifying the label of the classification to add. This API can also be called by including the enterprise ID in the URL explicitly, for example `/files/:id//enterprise_12345/securityClassification-6VMVochwUWo`.
This operation makes an HTTP POST request to the /files/{file_id}/metadata/enterprise/securityClassification-6VMVochwUWo endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create Box Skill cards on file
`<box:create-files-metadata-global-box-skills-cards-by-file-id>`
Applies one or more Box Skills metadata cards to a file. This operation makes an HTTP POST request to the /files/{file_id}/metadata/global/boxSkillsCards endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create upload session
`<box:create-files-upload-sessions>`
Creates an upload session for a new file. This operation makes an HTTP POST request to the /files/upload_sessions endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
## Create upload session
`<box:create-files-upload-sessions>`
Creates an upload session for a new file. This operation makes an HTTP POST request to the /files/upload_sessions endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create upload session for existing file
`<box:create-files-upload-sessions-by-file-id>`
Creates an upload session for an existing file. This operation makes an HTTP POST request to the /files/{file_id}/upload_sessions endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for requests to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Commit upload session
`<box:create-files-upload-sessions-commit-by-upload-session-id>`
Closes an upload session and create a file from the uploaded chunks. This operation makes an HTTP POST request to the /files/upload_sessions/{upload_session_id}/commit endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Upload session id | The ID of the upload session.  
The [RFC3230][1] message digest of the whole file. Only SHA1 is supported. The SHA1 digest must be Base64 encoded. The format of this header is as `sha=BASE64_ENCODED_DIGEST`. [1]: https://tools.ietf.org/html/rfc3230  
If match | Ensures this item hasn’t recently changed before making changes. Pass in the item’s last observed `etag` value into this header and the endpoint will fail with a `412 Precondition Failed` if it has changed since.  
If none match | Ensures an item is only returned if it has changed. Pass in the item’s last observed `etag` value into this header and the endpoint will fail with a `304 Not Modified` if the item has not changed since.  
Content to use | #[payload]  
Config Ref |  ConfigurationProvider | The name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for requests to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Revert file version
`<box:create-files-versions-current-by-file-id>`
Reverts to a previous version of a file. If previous versions exist, this method can be used to promote one of the older versions to the top of the version history. This creates a new copy of the old version of the file and puts it at the top of the versions history. The file will have the exact same contents as the older version, with the the same hash digest, `etag`, and name as the original. Other properties, such as comments do not get updated to their former values.
This operation makes an HTTP POST request to the /files/{file_id}/versions/current endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create folder lock on folder
`<box:create-folder-locks>`
Creates a folder lock on a folder, preventing it from being moved and/or deleted. This operation makes an HTTP POST request to the /folder_locks endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create folder
`<box:create-folders>`
Creates a new empty folder within the specified parent folder. This operation makes an HTTP POST request to the /folders endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Restore folder
`<box:create-folders-by-folder-id>`
Restores a folder that has been moved to the trash. An optional new parent ID can be provided to restore the folder to in case the original folder has been deleted.
**Folder locking**
During this operation, part of the file tree will be locked, mainly the source folder and all of its descendants, as well as the destination folder. For the duration of the operation, no other move, copy, delete, or restore operation can performed on any of the locked folders.
This operation makes an HTTP POST request to the /folders/{folder_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represents a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Copy folder
`<box:create-folders-copy-by-folder-id>`
Creates a copy of a folder within a destination folder. The original folder will not be changed. This operation makes an HTTP POST request to the /folders/{folder_id}/copy endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier of the folder to copy. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder with the ID `0` can not be copied.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create metadata instance on folder
`<box:create-folders-metadata-by-folder-id-scope-template-key>`
Applies an instance of a metadata template to a folder. In most cases, only values that are present in the metadata template will be accepted, with the exception of the `global.properties` template, which accepts any key-value pair.
To display the metadata template in the Box web app, the enterprise must be configured to enable **Cascading Folder Level Metadata** for the user in the admin console.
This operation makes an HTTP POST request to the /folders/{folder_id}/metadata/{scope}/{template_key} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
Enumeration, one of:
  * GLOBAL
  * ENTERPRISE

| The scope of the metadata template  
Template key | The name of the metadata template  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Add classification to folder
`<box:create-folders-metadata-enterprise-security-classification6vmvochwUwo-by-folder-id>`
Adds a classification to a folder by specifying the label of the classification to add. This API can also be called by including the enterprise ID in the URL explicitly, for example `/folders/:id//enterprise_12345/securityClassification-6VMVochwUWo`.
This operation makes an HTTP POST request to the /folders/{folder_id}/metadata/enterprise/securityClassification-6VMVochwUWo endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  *
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Add user to group
`<box:create-group-memberships>`
Creates a group membership. Only users with admin-level permissions will be able to use this API. This operation makes an HTTP POST request to the /group_memberships endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create group
`<box:create-groups>`
Creates a new group of users in an enterprise. Only users with admin permissions can create new groups. This operation makes an HTTP POST request to the /groups endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create user invite
`<box:create-invites>`
Invites an existing external user to join an enterprise. The existing user can not be part of another enterprise and must already have a Box account. Once invited, the user will receive an email and are prompted to accept the invitation within the Box web application. This method requires the "Manage An Enterprise" scope enabled for the application, which can be enabled within the developer console. This operation makes an HTTP POST request to the /invites endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create legal hold policy
`<box:create-legal-hold-policies>`
Create a new legal hold policy. This operation makes an HTTP POST request to the /legal_hold_policies endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Assign legal hold policy
`<box:create-legal-hold-policy-assignments>`
Assigns a legal hold to a file, file version, folder, or user. This operation makes an HTTP POST request to the /legal_hold_policy_assignments endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create metadata cascade policy
`<box:create-metadata-cascade-policies>`
Creates a new metadata cascade policy that applies a given metadata template to a given folder and automatically cascades it down to any files within that folder. In order for the policy to be applied a metadata instance must first be applied to the folder the policy is to be applied to. This operation makes an HTTP POST request to the /metadata_cascade_policies endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Force-apply metadata cascade policy to folder
`<box:create-metadata-cascade-policies-apply-by-metadata-cascade-policy-id>`
Forces the metadata on a folder with a metadata cascade policy to be applied to all of its children. This can be used after creating a new cascade policy to enforce the metadata to be cascaded down to all existing files within that folder.
This operation makes an HTTP POST request to the /metadata_cascade_policies/{metadata_cascade_policy_id}/apply endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Metadata cascade policy id | The ID of the cascade policy to force-apply.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Query files and folders by metadata
`<box:create-metadata-queries-execute-read>`
Create a search using SQL-like syntax to return items that match specific metadata. By default, this endpoint returns only the most basic info about the items for which the query matches. To get additional fields for each item, including any of the metadata, use the `fields` attribute in the query. This operation makes an HTTP POST request to the /metadata_queries/execute_read endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create metadata template
`<box:create-metadata-templates-schema>`
Creates a new metadata template that can be applied to files and folders. This operation makes an HTTP POST request to the /metadata_templates/schema endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Add initial classifications
`<box:create-metadata-templates-schemaclassifications>`
When an enterprise does not yet have any classifications, this API call initializes the classification template with an initial set of classifications. If an enterprise already has a classification, the template will already exist and instead an API call should be made to add additional classifications.
This operation makes an HTTP POST request to the /metadata_templates/schema#classifications endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create retention policy
`<box:create-retention-policies>`
Creates a retention policy. This operation makes an HTTP POST request to the /retention_policies endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS
## Create retention policy
`<box:create-retention-policies>`
Creates a retention policy. This operation makes an HTTP POST request to the /retention_policies endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Assign retention policy
`<box:create-retention-policy-assignments>`
Assigns a retention policy to an item. This operation makes an HTTP POST request to the /retention_policy_assignments endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Assign storage policy
`<box:create-storage-policy-assignments>`
Creates a storage policy assignment for an enterprise or user. This operation makes an HTTP POST request to the /storage_policy_assignments endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Assign task
`<box:create-task-assignments>`
Assigns a task to a user. A task can be assigned to more than one user by creating multiple assignments. This operation makes an HTTP POST request to the /task_assignments endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create task
`<box:create-tasks>`
Creates a single task on a file. This task is not assigned to any user and will need to be assigned separately. This operation makes an HTTP POST request to the /tasks endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream
| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create task
`<box:create-tasks>`
Creates a single task on a file. This task is not assigned to any user and will need to be assigned separately. This operation makes an HTTP POST request to the /tasks endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create terms of service status for new user
`<box:create-terms-of-service-user-statuses>`
Sets the status for a terms of service for a user. This operation makes an HTTP POST request to the /terms_of_service_user_statuses endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create terms of service
`<box:create-terms-of-services>`
Creates a terms of service for a given enterprise and type of user. This operation makes an HTTP POST request to the /terms_of_services endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create user
`<box:create-users>`
Creates a new managed user in an enterprise. This endpoint is only available to users and applications with the right admin permissions. This operation makes an HTTP POST request to the /users endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  *
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create email alias
`<box:create-users-email-aliases-by-user-id>`
Adds a new email alias to a user account. This operation makes an HTTP POST request to the /users/{user_id}/email_aliases endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The ID of the user.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create web link
`<box:create-web-links>`
Creates a web link object within a folder. This operation makes an HTTP POST request to the /web_links endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Restore web link
`<box:create-web-links-by-web-link-id>`
Restores a web link that has been moved to the trash. An optional new parent ID can be provided to restore the web link in case the original folder has been deleted.
This operation makes an HTTP POST request to the /web_links/{web_link_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Web link id | The ID of the web link.  
Array of String | A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create webhook
`<box:create-webhooks>`
Creates a webhook. This operation makes an HTTP POST request to the /webhooks endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS
### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create webhook
`<box:create-webhooks>`
Creates a webhook. This operation makes an HTTP POST request to the /webhooks endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Create zip download
`<box:create-zip-downloads>`
Creates a request to download multiple files and folders as a single `zip` archive file. This API does not return the archive but instead performs all the checks to ensure that the user has access to all the items, and then returns a `download_url` and a `status_url` that can be used to download the archive. The limit for an archive is either 32GB or 10,000 files, whichever limitation is met first.
This operation makes an HTTP POST request to the /zip_downloads endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove domain from list of allowed collaboration domains
`<box:delete-collaboration-whitelist-entries-by-collaboration-whitelist-entry-id>`
Removes a domain from the list of domains that have been deemed safe to create collaborations for within the current enterprise. This operation makes an HTTP DELETE request to the /collaboration_whitelist_entries/{collaboration_whitelist_entry_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Collaboration whitelist entry id | The ID of the entry in the list.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove user from list of users exempt from domain restrictions
`<box:delete-collaboration-whitelist-exempt-targets-by-collaboration-whitelist-exempt-target-id>`
Removes a user’s exemption from the restrictions set out by the allowed list of domains for collaborations. This operation makes an HTTP DELETE request to the /collaboration_whitelist_exempt_targets/{collaboration_whitelist_exempt_target_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Collaboration whitelist exempt target id | The ID of the exemption to the list.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  *
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove collaboration
`<box:delete-collaborations-by-collaboration-id>`
Deletes a single collaboration. This operation makes an HTTP DELETE request to the /collaborations/{collaboration_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Collaboration id | The ID of the collaboration  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove comment
`<box:delete-comments-by-comment-id>`
Permanently deletes a comment. This operation makes an HTTP DELETE request to the /comments/{comment_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Comment id | The ID of the comment.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove device pin
`<box:delete-device-pinners-by-device-pinner-id>`
Deletes an individual device pin. This operation makes an HTTP DELETE request to the /device_pinners/{device_pinner_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Device pinner id | The ID of the device pin  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Delete file request
`<box:delete-file-requests-by-file-request-id>`
Deletes a file request permanently. This operation makes an HTTP DELETE request to the /file_requests/{file_request_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
File request id | The unique identifier that represents a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/filerequest/123` the `file_request_id` is `123`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
## Delete file request
`<box:delete-file-requests-by-file-request-id>`
Deletes a file request permanently. This operation makes an HTTP DELETE request to the /file_requests/{file_request_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
File request id | The unique identifier that represents a file request. The ID for any file request can be determined by visiting a file request builder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/filerequest/123` the `file_request_id` is `123`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Delete file
`<box:delete-files-by-file-id>`
Deletes a file, either permanently or by moving it to the trash. The enterprise settings determine whether the item will be permanently deleted from Box or moved to the trash.
This operation makes an HTTP DELETE request to the /files/{file_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
If match | Ensures this item hasn’t recently changed before making changes. Pass in the item’s last observed `etag` value into this header and the endpoint will fail with a `412 Precondition Failed` if it has changed since.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove metadata instance from file
`<box:delete-files-metadata-by-file-id-scope-template-key>`
Deletes a piece of file metadata. This operation makes an HTTP DELETE request to the /files/{file_id}/metadata/{scope}/{template_key} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Enumeration, one of:
  * GLOBAL
  * ENTERPRISE

| The scope of the metadata template  
Template key | The name of the metadata template  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove classification from file
`<box:delete-files-metadata-enterprise-security-classification-by-file-id>`
Removes any classifications from a file. This API can also be called by including the enterprise ID in the URL explicitly, for example `/files/:id//enterprise_12345/securityClassification-6VMVochwUWo`.
This operation makes an HTTP DELETE request to the /files/{file_id}/metadata/enterprise/securityClassification-6VMVochwUWo endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove Box Skill cards from file
`<box:delete-files-metadata-global-box-skills-cards-by-file-id>`
Removes any Box Skills cards metadata from a file. This operation makes an HTTP DELETE request to the /files/{file_id}/metadata/global/boxSkillsCards endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Permanently remove file
`<box:delete-files-trash-by-file-id>`
Permanently deletes a file that is in the trash. This action cannot be undone. This operation makes an HTTP DELETE request to the /files/{file_id}/trash endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove upload session
`<box:delete-files-upload-sessions-by-upload-session-id>`
Abort an upload session and discard all data uploaded. This cannot be reversed. This operation makes an HTTP DELETE request to the /files/upload_sessions/{upload_session_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Upload session id | The ID of the upload session.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove file version
`<box:delete-files-versions-by-file-id-file-version-id>`
Moves a file version to the trash. Versions are only tracked for Box users with premium accounts. This operation makes an HTTP DELETE request to the /files/{file_id}/versions/{file_version_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
File version id | The ID of the file version  
If match | Ensures this item hasn’t recently changed before making changes. Pass in the item’s last observed `etag` value into this header and the endpoint will fail with a `412 Precondition Failed` if it has changed since.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove watermark from file
`<box:delete-files-watermark-by-file-id>`
Removes the watermark from a file. This operation makes an HTTP DELETE request to the /files/{file_id}/watermark endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/files/123` the `file_id` is `123`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Delete folder lock
`<box:delete-folder-locks-by-folder-lock-id>`
Deletes a folder lock on a given folder. This operation makes an HTTP DELETE request to the /folder_locks/{folder_lock_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder lock id | The ID of the folder lock.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Delete folder
`<box:delete-folders-by-folder-id>`
Deletes a folder, either permanently or by moving it to the trash. This operation makes an HTTP DELETE request to the /folders/{folder_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
recursive | Delete a folder that is not empty by recursively deleting the folder and all of its content.  
If match | Ensures this item hasn’t recently changed before making changes. Pass in the item’s last observed `etag` value into this header and the endpoint will fail with a `412 Precondition Failed` if it has changed since.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove metadata instance from folder
`<box:delete-folders-metadata-by-folder-id-scope-template-key>`
Deletes a piece of folder metadata. This operation makes an HTTP DELETE request to the /folders/{folder_id}/metadata/{scope}/{template_key} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
Enumeration, one of:
  * GLOBAL
  * ENTERPRISE

| The scope of the metadata template  
Template key | The name of the metadata template  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove classification from folder
`<box:delete-folders-metadata-enterprise-security-classification6vmvochw-uwo-by-folder-id>`
Removes any classifications from a folder. This API can also be called by including the enterprise ID in the URL explicitly, for example `/folders/:id//enterprise_12345/securityClassification-6VMVochwUWo`.
This operation makes an HTTP DELETE request to the /folders/{folder_id}/metadata/enterprise/securityClassification-6VMVochwUWo endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Permanently remove folder
`<box:delete-folders-trash-by-folder-id>`
Permanently deletes a folder that is in the trash. This action cannot be undone. This operation makes an HTTP DELETE request to the /folders/{folder_id}/trash endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove watermark from folder
`<box:delete-folders-watermark-by-folder-id>`
Removes the watermark from a folder. This operation makes an HTTP DELETE request to the /folders/{folder_id}/watermark endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Folder id | The unique identifier that represent a folder. The ID for any folder can be determined by visiting this folder in the web application and copying the ID from the URL. For example, for the URL the `folder_id` is `123`. The root folder of a Box account is always represented by the ID `0`.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove user from group
`<box:delete-group-memberships-by-group-membership-id>`
Deletes a specific group membership. Only admins of this group or users with admin-level permissions will be able to use this API. This operation makes an HTTP DELETE request to the /group_memberships/{group_membership_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Group membership id | The ID of the group membership.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove group
`<box:delete-groups-by-group-id>`
Permanently deletes a group. Only users with admin-level permissions will be able to use this API. This operation makes an HTTP DELETE request to the /groups/{group_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Group id | The ID of the group.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS
## Remove group
`<box:delete-groups-by-group-id>`
Permanently deletes a group. Only users with admin-level permissions will be able to use this API. This operation makes an HTTP DELETE request to the /groups/{group_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Group id | The ID of the group.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove legal hold policy
`<box:delete-legal-hold-policies-by-legal-hold-policy-id>`
Delete an existing legal hold policy. This is an asynchronous process. The policy will not be fully deleted yet when the response returns. This operation makes an HTTP DELETE request to the /legal_hold_policies/{legal_hold_policy_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Legal hold policy id | The ID of the legal hold policy  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Unassign legal hold policy
`<box:delete-legal-hold-policy-assignments-by-legal-hold-policy-assignment-id>`
Removes a legal hold from an item. This is an asynchronous process. The policy will not be fully removed yet when the response returns. This operation makes an HTTP DELETE request to the /legal_hold_policy_assignments/{legal_hold_policy_assignment_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Legal hold policy assignment id | The ID of the legal hold policy assignment  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE


## Remove metadata cascade policy
`<box:delete-metadata-cascade-policies-by-metadata-cascade-policy-id>`
Deletes a metadata cascade policy. This operation makes an HTTP DELETE request to the /metadata_cascade_policies/{metadata_cascade_policy_id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Metadata cascade policy id | The ID of the metadata cascade policy.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * 

### Throws
  * BOX:BAD_REQUEST
  * BOX:CLIENT_ERROR
  * BOX:CONNECTIVITY
  * BOX:INTERNAL_SERVER_ERROR
  * BOX:NOT_ACCEPTABLE
  * BOX:NOT_FOUND
  * BOX:RETRY_EXHAUSTED
  * BOX:SERVER_ERROR
  * BOX:SERVICE_UNAVAILABLE
  * BOX:TIMEOUT
  * BOX:TOO_MANY_REQUESTS
  * BOX:UNAUTHORIZED
  * BOX:UNSUPPORTED_MEDIA_TYPE