Uploading files via Postman with signed URLs

Upload files to Peak via signed URLs using Postman for graphical testing and debugging of file upload configurations.

Use Postman to upload files to Peak via signed URLs when you need a graphical interface for testing and debugging file uploads. This method is particularly useful for validating upload configurations before automating them.

Prerequisites

Before uploading files via Postman, ensure you have the following:

• You have Postman installed.
• You have a tenant API key.
• You have the file ready for upload on your local machine.

Steps

Follow these steps to upload a file to Peak using Postman. The process has two steps: generate a signed URL, then upload the file.

Step 1: Generate a signed URL

1. Open Postman and create a new request.
2. Set the request method to POST.
3. Enter the request URL: https://api.peak.ai/file/signedurl/client.
4. In the Headers tab, add:
   • Content-Type: application/json
   • Authorization: <tenant_api_key>
5. In the Body tab, select raw and enter:

   {"fileName":"<filename>.csv"}
   

6. Select Send.
7. If the request is successful, Postman returns a 200 OK response with a signed URL in the response body.

Step 2: Upload the file

1. Create a new request.
2. Set the request method to PUT.
3. Copy the signed URL from the response and paste it into the request URL field.
4. In the Headers tab, ensure the following is set:
   • Content-Type: text/csv (or the appropriate MIME type for your file)
   • Remove any authorization headers - signed URLs include authentication in the URL.
5. In the Body tab, select binary and choose the file to upload.
6. Select Send.
7. Verify the response:
   • A 200 OK response indicates successful upload.
   • Check the response body for any additional confirmation details.

Result

Your file uploads to Peak's file storage. The file becomes available for processing according to your configured data feeds and triggers.

Next steps

After the file uploads, create a file feed to ingest the data into your data warehouse and schedule the feed.

Troubleshooting

If you encounter errors during upload, refer to the following common issues and solutions:

• 403 Forbidden - The signed URL may have expired. Request a new signed URL.
• 400 Bad Request - Check that the Content-Type header matches your file type.
• 500 Server Error - Contact Peak support with the request details.