Bulk Operations: Download-Link

This feature is currently in production early-access. Functionality is subject to change as this feature is prepared for general access.

The Bulk Operations (BO) Download-Link API endpoint generates a URL address for exporting data out of the Unqork platform. For example, you could use the Bulk Data Operation: Export API Endpoint to export submission data into the Unqork Cloud, then generate a download link to retrieve the file. You can generate a download link using curl, Postman, or any other service that supports a POST request.

After generating a download link, you can download the submission data using a web browser, Postman, or any service that supports a GET request.

Discover how to set up API calls using a third-party program, view our Testing API Endpoints Using Third-Party Applications article.

Test the BO Download-Link endpoint using the Unqork Services page. To access the Unqork Services page, enter the following address into your browser: https://{environment}.unqork.io/fbu/uapi/docs/documentation/#/Bulk%20Operations/createDownloadLink. Replace {environment} with the name of your Unqork environment.

BO Download-Link uses the HTTP POST method and the following endpoint: https://{environment}.unqork.io/fbu/uapi/bulk-operations/download-link. Replace {environment} with the name of your Unqork environment.

Insert the following into the request body:

Copy
{
  "fileLocation": "string"
}

The following parameter is available for the Bulk Data Download-Link schema:

Key

Possible Values

Description

Required

fileLocation

string (no spaces)

Enter the Unqork Cloud file location key's value generated from the BDO Export operation. For example, unqorkResource/export/78bdc-df4a-41a61/0.csv.

You can find the Unqork Cloud file location using the BDO Get Job Details endpoint targeting the BDO Export's id value.

Optional

In the BO Download-Link response below, the downloadLink field contains the address of the exported file for download:

Copy
{
    "downloadLink": "/files/6734ce93abs9a01036b3f07c"
}

After generating a download link value, create a GET call using a web browser, Postman, or other API service.

Use the following endpoint: https://{{environment}}/api{{createFileDownloadLink}}. Replace {{environment}} with the name of your Unqork environment, and {{createFileDownloadLink}} with the downloadLink value. For example, https://training.unqork.io/api/files/6734ce93abs9a01036b3f07c.

Downloading Data Using Postman

To download the data using Postman:

1. In the Body Response window, next to the Save Response button, click the (ellipsis) button.
2. From the drop-down, select Save Response to file.

A static image displaying the Postman application. The triple elipsis button is highlighted, and the Save response to file button is highlighted.

3. Enter a name for the file and specify a local location where you want to download the file.
4. Click Save. The file saves in the format specified during the BDO Export operation.