Skip to main content
POST
Request Upload Url

Authorizations

X-API-Key
string
header
required

Cookies

wos-session
string
datalab_active_team
string

Body

application/json

Request to get a presigned upload URL.

filename
string
required

Original filename (used for storage path and metadata)

content_type
string
required

MIME type of the file

processing_location
string | null

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

Response

Successful Response

Response with presigned PUT URL for direct storage upload.

file_id
integer
required

Unique file ID (use this to confirm upload)

upload_url
string
required

Presigned PUT URL to upload the file to

reference
string
required

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

expires_in
integer
default:3600

URL expiry time in seconds