Upload or Download File

Returns the AWS credentials you need to upload a file to S3, or a URL that downloads a file from S3. The action query parameter controls which one you get.

Set action to upload to generate presigned values for the file upload. The response includes key, AWSAccessKeyId, x-amz-security-token, policy, and signature. After this call, open Upload File to S3, go to Body > form-data, and choose the CSV file that matches your operation.

Set action to download to generate a URL that downloads the requested file. Pass the responseFileId returned by Get ResponseFile as the fileId. If the response includes a url or fileUrl, pass it to Download via Pre-signed URL.

get

Authorizations

AuthorizationstringRequired

Send Bearer {token}, where {token} is the access_token returned by Request a token.

Path parameters

fileIdstringRequired

The ID of the file. For an upload, enter the fileId returned by Create File. For a download, enter the responseFileId returned by Get ResponseFile.

Query parameters

actionstring · enumRequired

Whether you are uploading a file or downloading one.

Example: uploadPossible values:

Responses

200

For action=upload, returns the presigned values for the S3 upload. For action=download, returns a presigned download URL.

No content

get/api/v2/file/{fileId}

GET /api/v2/file/{fileId}?action=upload HTTP/1.1
Host: files.api.example.com
Authorization: YOUR_API_KEY
Accept: */*

200

For action=upload, returns the presigned values for the S3 upload. For action=download, returns a presigned download URL.

No content