Skip to main content
GET
Presigned URLs
Presigned URLs allow you to offload file handling to clients while maintaining security and path locking.

1. Generate Presigned Token

Create a short-lived token that locks an upload to a specific path or folder. Method: GET
Path: /api/presigned-url

Authentication

Requires an API Key via Authorization, X-API-Key, or apiKey query parameter.

Query Parameters

string
If ends with /, locks to a folder. Otherwise, locks to a specific filename.
number
TTL for the token in seconds (default 3600).
boolean
Force UUID filenames for the upload.

Response


2. Upload via Token

Upload the file content using the generated token. Method: POST
Path: /api/presigned-url/:token

Headers

string
default:"multipart/form-data"
required
multipart/form-data

Note

The token is consumed immediately after one successful upload.

Example Flow