File upload methods

File upload methods supported in Peak, including manual uploads, file feeds, and signed URL uploads with time-limited authentication.

Peak supports multiple ways to upload files for ingestion. Use the method that matches your automation and security requirements.

What are signed URLs?

Peak uses signed URLs to securely upload files to your tenant. A signed URL contains time-limited authentication details in the query string and allows upload without sending credentials in the upload request.

Before you start

Before using signed URL uploads, ensure you have a tenant API key. Peak uses this key to authenticate requests that generate signed URLs.

Supported file types and formatting

Peak expects files to follow supported formats and naming conventions. For requirements, see File formats and naming conventions.

Upload methods

Method	Typical use case	Requirements
Ad hoc upload	Manual upload during onboarding or testing	File format compliance and naming rules
Signed URL (Postman)	Manual upload using Postman	Tenant API key
Signed URL (Python)	Automated upload via script	Tenant API key and Python 3
Signed URL (CLI)	Automated upload via command line	Tenant API key and cURL
FTP/SFTP	Scheduled file delivery from servers	FTP/SFTP server access and Peak IP allowlist

Using signed URLs

Uploading files with signed URLs is a two-step process:

1. Generate a signed URL by sending the file name to https://api.peak.ai/file/signedurl/client with your tenant API key.
2. Upload the file to the generated signed URL with a PUT request.

You can complete these steps using:

• Uploading files via command line with signed URLs
• Uploading files via Postman with signed URLs
• Uploading files via Python with signed URLs

Next steps

After a file upload, create a file feed to ingest the data into the data warehouse. For details, see Creating a file feed from Files.