POST

Generate File Resumable Upload Url


Generates a resumable upload URL to allow external clients to easily upload large files over 10MB to the Media Manager.

With the resumable upload URL, any interruptions in the upload process pauses the file upload, and resumes the file upload process after the interruption. The resumable upload URL is also helpful when network connection is poor. To learn how external clients can use the generated upload URL in the response to upload large files to the Media Manager, see Resumable Upload API (SDK | REST).

Note: When you upload a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about knowing when a file is ready (SDK | REST).

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings Services and Settings
Manage Media Manager
Manage Portfolio
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/site-media/v1/files/generate-resumable-upload-url

Body Params
mimeTypestringRequiredmaxLength 100

File mime type.


fileNamestringmaxLength 200

Temporary file name used to identify the file type. For example, a file named "myFile.jpeg" identifies as an "image/jpeg" file type.
Note: The name that appears in the Media Manager is taken from the filename parameter in the Generate File Upload Url call.


parentFolderIdstringmaxLength 100

ID of the file's parent folder.
This folder is the path root for the filePath.
Default: media-root.


privateboolean

Whether the file will be public or private. Learn more about private files (SDK | REST).


labelsArray <string>maxItems 500maxLength 200

Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by Google Vision API for images.


uploadProtocolstring

The upload protocol to use for implementing the resumable upload.


filePathstringmaxLength 100

Path to the folder where the file will be stored. For example, /videos/2024/december.
If parentFolderId is defined, the parent folder is used as the path root. Otherwise, the root is media-root. The folders in the path will be created if they don't already exist.

Response Object
uploadProtocolstring

The upload protocol to use for implementing the resumable upload.


uploadUrlstringformat WEB_URL

The URL for uploading a file to the Media Manager.


uploadTokenstringmaxLength 2000

Single-use upload token.

Generate a resumable upload URL
Request
cURL
curl -X POST \ 'https://www.wixapis.com/site-media/v1/files/generate-resumable-upload-url' \ -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \ --data-binary '{ "mimeType": "image/jpeg", "fileName": "T-shirt", "sizeInBytes": "2608831" "parentFolderId":"25284aa06584441ea94338fdcfbaba12", "private": false, "uploadProtocol": "TUS" }'
Response
JSON
{ "uploadToken": "bnfhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2OTljMTY0ZC0yNjUwLTQ3YTAtYjUyNy0wZWU0YjAyYTk2NmIiLCJhdWQiOiJ1cm46c2VydmljZTp1cGxvYWQiLCJpc3MiOiJ1cm46c2VydmljZTp1cGxvYWQiLCJleHAiOjE2NjE3OTI2NDIsImlhdCI6MTY2MTE4NzgzMiwiYnVja2V0IjoidXBsb2FkLXRtcC13aXhtcC1jZGZjMzg0ZjE1ODQxYWFhNWVhYjE2YjEiLCJwYXRoIjoibWVkaWEvNDAwMjc2XzM3NjI4Mzc0YmVhMTRkZDI4NWNhYjJlNDUzYTlmMGYwfm12Mi5qcGciLCJjYWxsYmFja1VybCI6Imh0dHBzOi8vd2l4bXAtY2RmYzM4NGYxNTg0MWFhYTVlYWIxNmIxLmFwcHNwb3QuY29tL19hcGkvdjMvdXBsb2FkL2NhbGxiYWNrP3VwbG9hZFRva2VuPWV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSklVekkxTmlKOS5leUpwYzNNaU9pSjFjbTQ2YzJWeWRtbGpaVHBtYVd4bExuVndiRzloWkNJc0ltRjFaQ0k2SW5WeWJqcHpaWEoyYVdObE9tWnBiR1V1ZFhCc2IyRmtJaXdpYzNWaUlqb2lkWEp1T21Gd2NEcGxOalkyTXpCbE56RTBaakEwT1RCaFlXVmhNV1l4TkRsaU0ySTJPV1V6TWlJc0ltbGhkQ0k2TVRZMk1URTROemd6TWl3aVpYaHdJam94TmpZeE1qTXhNRE15TENKcWRHa2lPaUkzTURNNFlUaGlObUptTnpVaUxDSmlhM1FpT2lKemRHRjBhV011ZDJsNGMzUmhkR2xqTG1OdmJTSXNJbkIwYUNJNklpOXRaV1JwWVM4ME1EQXlOelpmTXpjMk1qZ3pOelJpWldFeE5HUmtNamcxWTJGaU1tVTBOVE5oT1dZd1pqQi1iWFl5TG1wd1p5SXNJbUZqYkNJNkluQjFZbXhwWXlJc0lteG1ZeUk2Ym5Wc2JDd2lZMnhpSWpwN0luVnliQ0k2SW1oMGRIQnpPaTh2ZDJsNGNISnBkbUYwWlcxbFpHbGhMbUZ3Y0hOd2IzUXVZMjl0TDNZekwyMXdMMlpwYkdWekwzVndiRzloWkM5dFpXUnBZUzgwTURBeU56WmZNemMyTWpnek56UmlaV0V4TkdSa01qZzFZMkZpTW1VME5UTmhPV1l3WmpCLWJYWXlMbXB3WnlJc0ltRjBkR0ZqYUcxbGJuUWlPbnNpY0dGMGFDSTZJaTl0WldScFlTODBNREF5TnpaZk16YzJNamd6TnpSaVpXRXhOR1JrTWpnMVkyRmlNbVUwTlROaE9XWXdaakItYlhZeUxtcHdaeUlzSW5Wd2JHOWhaRjkwYjJ0bGJpSTZJa0pNYkZadFNDMTBWVTQzYVdoSFFqTlBiRWRLU25wVVZtVnlWakIwT1hadmJIRTNjM3BWUm5GeWFqTklia3BLV2s1dE0wWkNRekZqT1Y5cGVtOVhMVnBTZVRoM00xaDBaMng2ZEZVMGJDMVFkRlowYVRVemVXbGhUalpTU1dGUmIzbGFPVmRJU1VaT09EUjZiV2xDUVd4U09IRkRWMjlGWVdnNVdubFVaVTFxYkhWMFRtdGlORFJVVWpKSFppMXdVMVU1Y0c5TGVucHdjMDFMWDB4RWRtNVlURnBYV1VwS2QwOVJkV3A1VUZKUmNYZENlR1Z2WmxsWmFIVnBWRWhaTWt4RU5HSllSbXMzYWtFNFJHNWtMVjlZUVhWU1NXSnJiVEpyUnpnM04wcGhTVWRpY0VaNVQwd3lVbXgyZVY5SFNrSXhYMFp3ZUVkb2VtOXRlbU4zVVdkSGNqSmxTVU5oV1RKaFNFVmFXWFpWTVhaNE5GaDFXR1ZvYjJwcGNXbFlNR1JMTUc4M2NVSnJPVFpzV1hvNGJsQkZZMEZvTWpSdlJXeDZObmRqVFRoVFNqQlNUM1JDWDA5cFVrbENhSFphVmpoa1pEZEpTSHAzU1hsdlZVbzRhVkZRYXpkc2FUZHljVFV5ZWxwNmNXcFRSMDVLV0hOMldFdGhZeTFuTW1GVk4zSmZMWHBSTW1GcE1qZFVUa1YxT1d0ZlVVUnpOMjB6VjNZNE5GaDBkVjh3UTFNMFlXd3pNVVJETVhwTVVIWjBNRVpKUW1GdFRtdHBOVFpMWkhCcVRtOXRkRTl3WnpaTE9FMVZhRkJ3U1ZWSVpXTjFMVTF3ZW1SSFptdGphalUxTkd4VWVXcFBUMTlRU1d4RFFUUlVVR3M0ZDA5QldtNWtUM1p5T0hReVEzQkxJbjBzSW1obFlXUmxjbk1pT201MWJHd3NJbkJoYzNOMGFISnZkV2RvSWpwMGNuVmxmWDAuZ2Z4b19vWGFFQ3JNWjNvbVdFaVBVZVdDQWpGTGlXRnNXdXZRNmdZelpUTSIsImFjbCI6InB1YmxpYyIsInByb3RvY29sIjoidHVzIiwibWltZVR5cGUiOiJpbWFnZS9qcGVnIiwic2Vzc2lvblVSTCI6Imh0dHBzOi8vd3d3Lmdvb2dsZWFwaXMuY29tL3VwbG9hZC9zdG9yYWdlL3YxL2IvdXBsb2FkLXRtcC13aXhtcC1jZGZjMzg0ZjE1ODQxYWFhNWVhYjE2YjEvbz9wcmVkZWZpbmVkQWNsPXB1YmxpY1JlYWRcdTAwMjZwcm9qZWN0aW9uPWZ1bGxcdTAwMjZ1cGxvYWRUeXBlPXJlc3VtYWJsZVx1MDAyNnVwbG9hZF9pZD1BRFB5Y2R2TnlvRTVhQ05rLWx2UGtZR01Ib0pWeUxQV0F2V0s3TXlhbXIwRHVDQUxIT2FlU2p1emZnVWpCMVp3UGhZRGg4XzdxeTVncFNnVlhjRUZFMGlWd2t4YmNRIn0.Fq3U6_ogjXdHXpBLZ1rZOz7NF_r9PHPNlG_R2jVqNQY", "uploadUrl": "https://upload.wixmp.com/upload/tus", "uploadProtocol": "TUS" }
Errors
400Invalid Argument

There are 4 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?