Sign in

v1

latestOpenAPI 3.1.02026-07-26151126273.9 KB
files

Request Upload Url

Request a presigned upload URL for direct client-side upload to storage.

This is the recommended upload flow:

  1. Client calls this endpoint with filename and content_type
  2. Backend creates a pending file record and returns presigned PUT URL
  3. Client uploads directly to storage using the presigned URL
  4. Client calls /confirm to verify upload and get actual file size
post/api/v1/files/upload

Cookies

wos-sessionstring
datalab_active_teamstring

Request body

filenamestring required

Original filename (used for storage path and metadata)

content_typestring required

MIME type of the file

processing_locationstring nullable

Optional residency region override (e.g. us, eu). When provided, the direct-upload URL is issued for storage in that region.

Response

Successful Response

file_idinteger required

Unique file ID (use this to confirm upload)

upload_urlstring required

Presigned PUT URL to upload the file to

expires_ininteger

URL expiry time in seconds

referencestring required

File reference in datalab://file-{id} format