Skip to main content

Request Datasource Upload

Available November 2026 and later.

Creates a short-lived staged upload URL for a Tableau TDS or TDSX data source. PUT exactly fileSizeBytes bytes to the returned URL with the returned requiredHeaders, then call publish-datasource with the returned datasourceUploadId. Each upload id can be published once.

APIs called​

Talks to Tableau Cloud or Tableau Server.

  • Creates a short-lived staged upload URL for a Tableau TDS or TDSX data source.

Required arguments​

fileName​

Name of the Tableau data source file to upload. Must end in .tds or .tdsx.

fileSizeBytes​

Exact file size in bytes; the upload must send exactly this many bytes (available November 2026 and later). Range: 1-5000000000.

Worked example​

{
"datasourceUploadId": "123e4567-e89b-42d3-a456-426614174000",
"uploadUrl": "https://s3.example.com/signed-put",
"expiresAt": "2026-10-14T18:05:00.000Z",
"maxSizeBytes": 5000000000,
"requiredHeaders": {
"Content-Type": "application/octet-stream"
}
}

The content type is application/xml for TDS and application/octet-stream for TDSX. Staged publishing retains the advertised 5 GB (5000000000 bytes) limit. The signed URL does not constrain the PUT size; oversized staged objects are rejected before uploading to Tableau. Configure S3 lifecycle rules for staged-file expiry. Publishing buffers the file in server memory.