Skip to main content

Generate a pre-signed upload URL

POST 
/api/v1/storage/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). sizeBytes 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 requiredHeaders the client must send verbatim with the PUT, and the fileId to pass to register-uploaded-file afterwards.

Request​

Responses​

Upload URL generated