Multipart Upload

Upload a file from the Workflows file system to a web service, using HTTP or HTTPS, using multipart form-data.

You may need to obtain the required input field data from a third-party service. The output is dependent on the response from the service. To access a particular response properly, create an output with the same name as the key in the response object.

File functions do not support shareable links such as those from Box, OneDrive, or Google Drive.

Options

Field Definition Type Required
Use Custom File Parameters Indicates whether to use custom file parameters Dropdown TRUE

Input

Field Definition Type Required
File
File Content ID of the file contents. File FALSE
File Name Name of the file, including an extension. String FALSE
Http
URL URL of the request, including the protocol http:// or https://. String FALSE
Method HTTP method to use (PUT or POST). Dropdown FALSE
Headers User-created fields that define headers to use in the file request. Object FALSE
Data
Input File attributes of the file, such as file ID and file name. String FALSE

Output

Field Definition Type
Body Parsed response body for JSON properties or values. String
Raw Body
body Raw response body passed at runtime. String

Example

Upload a file to Box.

  1. In the Use Custom File Parameter dropdown, select No. This option allows you to specify one or more custom inputs and define their names. The values can be passed at runtime, and these properties and values will be included in the multipart body of the message.
  2. Drag the File Content field output from a Download card to the Multipart Upload card's File Content field.

  3. Drag the File Name field output from a Download card to the Multipart Upload card's File Name field.

  4. Add a URL as the destination of the uploaded file.

  5. Include the http:// or https:// part, and any query string parameters, in the URL input.

  6. From the Method dropdown, select POST.

  7. Pass an authorization bearer token as a header into the Header field. For example, add a header Authorization: Bearer my-token by adding an Authorization key to the Headers section and setting its value to Bearer my-token.  You can also set Content-type: application/image similarly.

  1. In the Data section, create a field and name it attributes.

  2. Pass a JSON object that supplies the attributes of the file (folder ID and file name). The file must already be in the Workflows file system. For example: { "parent": { "id": "108297462713" }, "name": "humans.txt" }

Related topics

Functions in Workflows

Elements of Workflows