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).
You can only call this method when authenticated as a Wix app or Wix user identity.
File mime type.
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.
ID of the file's parent folder.
This folder is the path root for the filePath
.
Default: media-root
.
Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by Google Vision API for images.
The upload protocol to use for implementing the resumable upload.
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.
The upload protocol to use for implementing the resumable upload.
The URL for uploading a file to the Media Manager.
Single-use upload token.
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"
}'
{
"uploadToken": "bnfhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2OTljMTY0ZC0yNjUwLTQ3YTAtYjUyNy0wZWU0YjAyYTk2NmIiLCJhdWQiOiJ1cm46c2VydmljZTp1cGxvYWQiLCJpc3MiOiJ1cm46c2VydmljZTp1cGxvYWQiLCJleHAiOjE2NjE3OTI2NDIsImlhdCI6MTY2MTE4NzgzMiwiYnVja2V0IjoidXBsb2FkLXRtcC13aXhtcC1jZGZjMzg0ZjE1ODQxYWFhNWVhYjE2YjEiLCJwYXRoIjoibWVkaWEvNDAwMjc2XzM3NjI4Mzc0YmVhMTRkZDI4NWNhYjJlNDUzYTlmMGYwfm12Mi5qcGciLCJjYWxsYmFja1VybCI6Imh0dHBzOi8vd2l4bXAtY2RmYzM4NGYxNTg0MWFhYTVlYWIxNmIxLmFwcHNwb3QuY29tL19hcGkvdjMvdXBsb2FkL2NhbGxiYWNrP3VwbG9hZFRva2VuPWV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSklVekkxTmlKOS5leUpwYzNNaU9pSjFjbTQ2YzJWeWRtbGpaVHBtYVd4bExuVndiRzloWkNJc0ltRjFaQ0k2SW5WeWJqcHpaWEoyYVdObE9tWnBiR1V1ZFhCc2IyRmtJaXdpYzNWaUlqb2lkWEp1T21Gd2NEcGxOalkyTXpCbE56RTBaakEwT1RCaFlXVmhNV1l4TkRsaU0ySTJPV1V6TWlJc0ltbGhkQ0k2TVRZMk1URTROemd6TWl3aVpYaHdJam94TmpZeE1qTXhNRE15TENKcWRHa2lPaUkzTURNNFlUaGlObUptTnpVaUxDSmlhM1FpT2lKemRHRjBhV011ZDJsNGMzUmhkR2xqTG1OdmJTSXNJbkIwYUNJNklpOXRaV1JwWVM4ME1EQXlOelpmTXpjMk1qZ3pOelJpWldFeE5HUmtNamcxWTJGaU1tVTBOVE5oT1dZd1pqQi1iWFl5TG1wd1p5SXNJbUZqYkNJNkluQjFZbXhwWXlJc0lteG1ZeUk2Ym5Wc2JDd2lZMnhpSWpwN0luVnliQ0k2SW1oMGRIQnpPaTh2ZDJsNGNISnBkbUYwWlcxbFpHbGhMbUZ3Y0hOd2IzUXVZMjl0TDNZekwyMXdMMlpwYkdWekwzVndiRzloWkM5dFpXUnBZUzgwTURBeU56WmZNemMyTWpnek56UmlaV0V4TkdSa01qZzFZMkZpTW1VME5UTmhPV1l3WmpCLWJYWXlMbXB3WnlJc0ltRjBkR0ZqYUcxbGJuUWlPbnNpY0dGMGFDSTZJaTl0WldScFlTODBNREF5TnpaZk16YzJNamd6TnpSaVpXRXhOR1JrTWpnMVkyRmlNbVUwTlROaE9XWXdaakItYlhZeUxtcHdaeUlzSW5Wd2JHOWhaRjkwYjJ0bGJpSTZJa0pNYkZadFNDMTBWVTQzYVdoSFFqTlBiRWRLU25wVVZtVnlWakIwT1hadmJIRTNjM3BWUm5GeWFqTklia3BLV2s1dE0wWkNRekZqT1Y5cGVtOVhMVnBTZVRoM00xaDBaMng2ZEZVMGJDMVFkRlowYVRVemVXbGhUalpTU1dGUmIzbGFPVmRJU1VaT09EUjZiV2xDUVd4U09IRkRWMjlGWVdnNVdubFVaVTFxYkhWMFRtdGlORFJVVWpKSFppMXdVMVU1Y0c5TGVucHdjMDFMWDB4RWRtNVlURnBYV1VwS2QwOVJkV3A1VUZKUmNYZENlR1Z2WmxsWmFIVnBWRWhaTWt4RU5HSllSbXMzYWtFNFJHNWtMVjlZUVhWU1NXSnJiVEpyUnpnM04wcGhTVWRpY0VaNVQwd3lVbXgyZVY5SFNrSXhYMFp3ZUVkb2VtOXRlbU4zVVdkSGNqSmxTVU5oV1RKaFNFVmFXWFpWTVhaNE5GaDFXR1ZvYjJwcGNXbFlNR1JMTUc4M2NVSnJPVFpzV1hvNGJsQkZZMEZvTWpSdlJXeDZObmRqVFRoVFNqQlNUM1JDWDA5cFVrbENhSFphVmpoa1pEZEpTSHAzU1hsdlZVbzRhVkZRYXpkc2FUZHljVFV5ZWxwNmNXcFRSMDVLV0hOMldFdGhZeTFuTW1GVk4zSmZMWHBSTW1GcE1qZFVUa1YxT1d0ZlVVUnpOMjB6VjNZNE5GaDBkVjh3UTFNMFlXd3pNVVJETVhwTVVIWjBNRVpKUW1GdFRtdHBOVFpMWkhCcVRtOXRkRTl3WnpaTE9FMVZhRkJ3U1ZWSVpXTjFMVTF3ZW1SSFptdGphalUxTkd4VWVXcFBUMTlRU1d4RFFUUlVVR3M0ZDA5QldtNWtUM1p5T0hReVEzQkxJbjBzSW1obFlXUmxjbk1pT201MWJHd3NJbkJoYzNOMGFISnZkV2RvSWpwMGNuVmxmWDAuZ2Z4b19vWGFFQ3JNWjNvbVdFaVBVZVdDQWpGTGlXRnNXdXZRNmdZelpUTSIsImFjbCI6InB1YmxpYyIsInByb3RvY29sIjoidHVzIiwibWltZVR5cGUiOiJpbWFnZS9qcGVnIiwic2Vzc2lvblVSTCI6Imh0dHBzOi8vd3d3Lmdvb2dsZWFwaXMuY29tL3VwbG9hZC9zdG9yYWdlL3YxL2IvdXBsb2FkLXRtcC13aXhtcC1jZGZjMzg0ZjE1ODQxYWFhNWVhYjE2YjEvbz9wcmVkZWZpbmVkQWNsPXB1YmxpY1JlYWRcdTAwMjZwcm9qZWN0aW9uPWZ1bGxcdTAwMjZ1cGxvYWRUeXBlPXJlc3VtYWJsZVx1MDAyNnVwbG9hZF9pZD1BRFB5Y2R2TnlvRTVhQ05rLWx2UGtZR01Ib0pWeUxQV0F2V0s3TXlhbXIwRHVDQUxIT2FlU2p1emZnVWpCMVp3UGhZRGg4XzdxeTVncFNnVlhjRUZFMGlWd2t4YmNRIn0.Fq3U6_ogjXdHXpBLZ1rZOz7NF_r9PHPNlG_R2jVqNQY",
"uploadUrl": "https://upload.wixmp.com/upload/tus",
"uploadProtocol": "TUS"
}
There are 4 errors with this status code.
This method may also return standard errors. Learn more about standard Wix errors.