Skip to main content

Request Workbook Upload

Available November 2026 and later.

Creates a short-lived staged upload URL for a Tableau TWB or TWBX workbook. PUT exactly fileSizeBytes bytes to the returned URL with the returned requiredHeaders, then call publish-workbook with the returned workbookUploadId. 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 TWB or TWBX workbook.

Required arguments​

fileName​

Name of the Tableau workbook file to upload. Must end in .twb or .twbx.

fileSizeBytes​

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

Response behavior​

The tool returns a presigned S3 PUT URL and an opaque workbookUploadId. Upload the raw workbook bytes to uploadUrl with the given requiredHeaders before expiresAt, then pass workbookUploadId to Publish Workbook. The upload is not visible to Tableau until publish-workbook is called — this tool only stages the bytes.

Worked example​

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