Supply Chain & Retail Solutions user guide

Prerequisites​

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

Steps​

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:
   assignment

   {"fileName":"<filename>.csv"}
   {"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​

Next steps​

Troubleshooting​

• 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.