Upload

Upload a file from the Workflows file system to a web service using HTTP or HTTPS.

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

Input Fields

  • File Content (file): the ID of the file contents to upload

  • URL (text): the URL of the request, including the protocol http:// or https://

  • Method(dropdown): http method to use (PUT or POST)

  • Headers (text): user-created fields to define headers to use in the file request

Output Fields

  • Body(text): response body that's been parsed for JSON properties or values

  • Raw Body(text): raw response body that was passed at runtime

Use Upload Function

To use this function:

  1. Identify the file to upload by dragging an existing File type (typically called File Contents) from a previous card in the Flow. For example, use file contents from a download card from another cloud service.

  2. Specify the URL, including the http:// or https:// part and any query string parameters, in the URL input.

  3. Select the HTTP method - PUT or POST - and set any headers required by the service.

Typically, there will be one or more headers required, especially for authentication.

For example, if the site requires authorization, you could 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.

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.

Example

Here is an example of accessing the Algorithmia file system. Algorithmia requires that the full file path and filename of the destination file be specified in the URL. It also requires an authentication token (replace that with a real one) and a specific Content-Type.

See Also

Functions in Workflows

About the elements of Okta Workflows