Skip to main content

Generate signed upload URL for ephemeral file

POST 
/v1/ephemeral/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.

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 hash to reference the file in subsequent API calls

Request​

Responses​

Signed upload URL generated