Upload Asset

The first step in uploading an asset to a site.

This endpoint generates a response with the following information: uploadUrl and uploadDetails.

Use these properties in the header of a POST request to Amazson s3 to complete the upload.

To learn more about how to upload assets to Webflow, see our assets guide.

Required scope | assets:write

Path parameters

site_idstringRequiredformat: "objectid"
Unique identifier for a Site

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Information about the asset to create
fileNamestringRequired
File name including file extension. File names must be less than 100 characters.
fileHashstringRequired
MD5 hash of the file
parentFolderstringOptional

ID of the Asset folder (optional)

Response

Request was successful
uploadDetailsobject or null
Metadata for uploading the asset binary
contentTypestring or null
idstring or nullformat: "objectid"
parentFolderstring or nullformat: "objectid"
Parent folder for the asset
uploadUrlstring or nullformat: "uri"
assetUrlstring or nullformat: "uri"
S3 link to the asset
hostedUrlstring or nullformat: "uri"
Represents the link to the asset
originalFileNamestring or null
Original file name when uploaded. If not specified at time of upload, it may be extracted from the raw file name
createdOnstring or nullformat: "date-time"
Date the asset metadata was created
lastUpdatedstring or nullformat: "date-time"
Date the asset metadata was last updated

Errors