Generates an upload URL to allow external clients to upload a file to the Media Manager.
To learn how external clients can use the generated upload URL in the response to upload a file to the Media Manager, see Upload API (SDK | REST).
Notes:
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.
A place to map an external entity to an uploaded file in the Wix Media Manager.
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 URL for uploading a file to the Media Manager.
curl -X POST \
'https://www.wixapis.com/site-media/v1/files/generate-upload-url' \
-H 'Authorization: <AUTH>'
-H 'Content-Type: application/json' \
--data-binary '{
"mimeType": "image/jpeg",
"fileName": "T-shirt.jpg",
"sizeInBytes": "2608831"
"parentFolderId":"25284aa06584441ea94338fdcfbaba12",
"private": false,
"labels": ["AMS:external_file_id", "woman", "bicycle"]
}'
{
"uploadUrl": "https://upload.wixmp.com/upload/bnfhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2MWI2ZjkzOS03YWExLTQxMTgtOGY3ZS03ZTRjOWJkYTk4YzgiLCJhdWQiOiJ1cm46c2VydmljZTp1cGxvYWQiLCJpc3MiOiJ1cm46c2VydmljZTp1cGxv6WQiLCJleHAiOjE2NjIwNTQ5OTMsImlhdCI6MTY2MTk2ODU4MywiYnVja2V0IjoidXBsb2FkLXRtcC13aXhtcC1jZGZjMzg0ZjE1ODQxYWFhNWVhYjE2YjEiLCJwYXRoIjoibWVkaWEvMmFjYmI4X2VmMDMwOTU0YjZmYjQ4ZWViMmQ4ZDJkYzYwNTEwZThjfm12Mi5qcGciLCJjYWxsYmFja1VybCI6Imh0dHBzOi8vd2l4bXAtY2RmYzM4NGYxNTg0MWFhYTVlYWIxNmIxLmFwcHNwb3QuY29tL19hcGkvdjMvdXBsb2FkL2NhbGxiYWNrP3VwbG9hZFRva2VuPWV5SjBlWEFpT2lKS1YxUWlMQ0poYkdjaU9pSklVekkxTmlKOS5leUpwYzNNaU9pSjFjbTQ2YzJWeWRtbGpaVHBtYVd4bExuVndiRzloWkNJc0ltRjFaQ0k2SW5WeWJqcHpaWEoyYVdObE9tWnBiR1V1ZFhCc2IyRmtJaXdpYzNWaUlqb2lkWEp1T21Gd2NEcGxOalkyTXpCbE56RTBaakEwT1RCaFlXVmhNV1l4TkRsaU0ySTJPV1V6TWlJc0ltbGhkQ0k2TVRZMk1UazJPRFU0TXl3aVpYaHdJam94TmpZeU1ERXhOemd6TENKcWRHa2lPaUkzT1RKa09EZzBOalEzTm1ZaUxDSmlhM1FpT2lKemRHRjBhV011ZDJsNGMzUmhkR2xqTG1OdmJTSXNJbkIwYUNJNklpOXRaV1JwWVM4eVlXTmlZamhmWldZd016QTVOVFJpTm1aaU5EaGxaV0l5WkRoa01tUmpOakExTVRCbE9HTi1iWFl5TG1wd1p5SXNJbUZqYkNJNkluQjFZbXhwWXlJc0lteG1ZeUk2Ym5Wc2JDd2lZMnhpSWpwN0luVnliQ0k2SW1oMGRIQnpPaTh2ZDJsNGNISnBkbUYwWlcxbFpHbGhMbUZ3Y0hOd2IzUXVZMjl0TDNZekwyMXdMMlpwYkdWekwzVndiRzloWkM5dFpXUnBZUzh5WVdOaVlqaGZaV1l3TXpBNU5UUmlObVppTkRobFpXSXlaRGhrTW1Sak5qQTFNVEJsT0dOLWJYWXlMbXB3WnlJc0ltRjBkR0ZqYUcxbGJuUWlPbnNpY0dGMGFDSTZJaTl0WldScFlTOHlZV05pWWpoZlpXWXdNekE1TlRSaU5tWmlORGhsWldJeVpEaGtNbVJqTmpBMU1UQmxPR04tYlhZeUxtcHdaeUlzSW5Wd2JHOWhaRjkwYjJ0bGJpSTZJa0pNYkZadFNDMTBWVTQzYVdoSFFqTlBiRWRLU25wVVZtVnlWakIwT1hadmJIRTNjM3BWUm5GeWFqTklia3BLV2s1dE0wWkNRekZqT1Y5cGVtOVhMVnBTZVRoM00xaDBaMng2ZEZVMGJDMVFkRlowYVRVemVXbGhUalpTU1dGUmIzbGFPVmRJU1VaT09EUjZiV2xDUVd4U09IRkRWMjlGWVdnNVdubFVaVTFxYkhCZlRVVkdiM0ZzUkVKRFdFZElUV05OV2xWamMxcGhha3N3WjFGRE4wTkZTa0ZrYUU5a1ZsWjVObEZDVUhwaFdYVkNNbEkwYTBORlpERXdhbGRvUjNOM2JWa3RkblZNVlVkNFdIVjBValoyYWxWb2NUWjFiV0pXT1V4WWRWVTFabUZ1ZFRWZlFsSmxWVkYxWTBGUFMzUXpVblJ3VTFwSVZrRnBXVmROUlZOemNuRXdhelE1ZWtoalowSjJRVXhTTUZWTGQxaE9XV1poTmpWUU1ISTFOa2N5TjAxd1ZFTXRVRms1V1hkT1ozbzRWMUJKVWpoSU1tRnNOMXBLYXpWSlpXdEpNRkF4VFdoSk5reENjVUZtU1ZKdFkyOWZVbTF4ZUVoa1dVcGtia2d4ZDIxTlNrTTRjbG95UlZsMFNUZDRVelpVT0dFMWRsRmpaVk53VW5oMU9URTFYMEYyT1ZaM1pXaHhUbWR6ZHpkSVZVaE1SVlpwWVV0ZmRsOVlZMmsxWTJNeVNFMURRbTFTT0hNOUluMHNJbWhsWVdSbGNuTWlPbTUxYkd3c0luQmhjM04wYUhKdmRXZG9JanAwY25WbGZYMC5WNWV4TndIdTAtXzltYzhMMUtYTUItdFRUVE9WS2czZTZnbnVSQlNtcThFIiwiYWNsIjoicHVibGljIiwibWltZVR5cGUiOiJpbWFnZS9qcGVnIn0.Z-R2i-w9YzBH4vkkP3RjaXaqj-QPnu-cyvQd5h_oTyE"
}
There are 5 errors with this status code.
This method may also return standard errors. Learn more about standard Wix errors.