Skip to main content

Generate signed upload URL

POST 
/v1/files/upload-url

Generates a time-limited signed URL for direct upload to cloud storage. The client must compute the SHA-256 hash of the file content before calling this endpoint.

If the file already exists (matching hash), the response will have exists: true and no upload URL will be provided - the file can be used immediately via the returned fileRef.

Direct Upload Flow:

  1. Client computes SHA-256 hash of file content
  2. Call this endpoint with the hash and content type
  3. If exists: false, upload file directly to the uploadUrl using PUT
  4. Use the fileRef to reference the file in subsequent API calls

Project Scoping: For OAuth auth, requires X-Project-ID header.

Request​

Responses​

Signed upload URL generated