Skip to main content

Generate a pre-signed upload URL

POST 
/api/v1/storage/gateway/generate-upload-url

Step 1 of the 3-step upload flow. Generates a time-limited pre-signed URL for uploading directly to the storage backend (bypassing the gateway for the actual bytes). size_bytes is required: it is pre-checked against the user's quota and cryptographically bound into the URL (x-goog-content-length-range), so the storage backend itself rejects larger uploads. The response includes required_headers the client must send verbatim with the PUT, and the file_id to pass to register-uploaded-file afterwards.

Request​

Responses​

Upload URL generated