Go Headless

Build Apps

Client

API Preview

Develop Websites

REST

Velo

GraphQL (Alpha)

# Upload API
This article demonstrates how to use the `uploadUrl` response from the [Generate File Upload Url](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::439cd7bb-6c63-4fdb-a2f9-5996001fa883slug::generate-file-upload-url*fallback::https://dev.wix.com/api/rest/media/media-manager/files/generate-file-upload-url) endpoint to upload a file to a site's Media Manager. 
## Authorization
This endpoint uses the upload token included in the url for authorization.
No additional authorization is needed.
                                   

## Syntax
```html
PUT {{generateFileUploadUrlResponse.uploadUrl}}
```

[//]: # (## Path Params)

[//]: # (| Name     | Type   | Optional | Description                                                                                                                             |)

[//]: # (|----------|--------|:--------:|-----------------------------------------------------------------------------------------------------------------------------------------|)

[//]: # (| filename | string |    no    | File name that appears in the Media Manager. Include the file's extension in its name to prevent potential errors. |)


## Headers Params
| Name         | Type   | Optional | Description                                                                     |
|--------------|--------|:--------:|---------------------------------------------------------------------------------|
| Content-Type | string |    no    | File content type. For example, "image/jpeg" for a jpg file. |


## Query Params
| Name      | Type    | Optional   | Description                                                                                                                             |
|-----------|---------|:----------:|-----------------------------------------------------------------------------------------------------------------------------------------|
| filename  | string  |     no     | File name that appears in the media manager. Include the file's extension in the name to prevent potential errors. |


>**Note:** In case of failure due to incorrect `mimeType`, include the file's extension in the `filename` parameter and set the `Content-Type` to 'application/octet-stream'. Doing this allows Wix servers to detect the correct content type of the file.

## Request
```typescript
async function uploadMyFile(uploadUrl, fileContent) {
  const params = {'filename':'my-audo-track.mp3'};
  const headers = {
    'Content-Type': 'application/octet-stream'
  }      

  const uploadResponse = await httpClient.put( uploadUrl, fileContent, { headers, params } );
  return uploadResponse;
}
```

>**Note:** Receiving a successful response does not indicate that the upload is complete. To run code when the upload finishes, use the [Descriptor File Ready](fallback::https://dev.wix.com/docs/rest/assets/media/media-manager/files/descriptor-file-ready) and [Descriptor File Failed](fallback::https://dev.wix.com/docs/rest/assets/media/media-manager/files/descriptor-file-failed) webhooks. Learn more about [knowing when a file is ready](fallback::https://dev.wix.com/docs/rest/assets/media/media-manager/importing-files#knowing-when-the-file-is-ready).


## Response
```json
{
  "file": {
    "id": "2acbb8_86485e224dd84143ba2f228777217bb7~mv2.jpeg",
    "displayName": "file.jpg",
    "url": "https://static.wixstatic.com/media/2acbb8_86485e224dd84143ba2f228777217bb7~mv2.jpeg",
    "parentFolderId": "media-root",
    "hash": "cf96f0567ed967f02bc9580ab8db86be",
    "sizeInBytes": "15359",
    "private": false,
    "mediaType": "IMAGE",
    "media": {
      "image": {
        "image": {
          "id": "2acbb8_86485e224dd84143ba2f228777217bb7~mv2.jpeg",
          "url": "https://static.wixstatic.com/media/2acbb8_86485e224dd84143ba2f228777217bb7~mv2.jpeg",
          "height": 226,
          "width": 370,
          "filename": "myfilename.jpg",
          "sizeInBytes": "15359"
        },
        "faces": []
      }
    },
    "operationStatus": "READY",
    "thumbnailUrl": "https://static.wixstatic.com/media/2acbb8_86485e224dd84143ba2f228777217bb7~mv2.jpeg",
    "labels": [],
    "createdDate": "2022-09-11T15:13:24.000Z",
    "updatedDate": "2022-09-11T15:13:24.000Z"
  }
}
```


## Status/Error Codes
The response will include an [HTTP status code](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::6668cae1-05d6-42d0-bc32-5edecc49104a*fallback::https://dev.wix.com/api/rest/getting-started/errors).