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

uploadDetailsobjectOptional

Metadata for uploading the asset binary

contentTypestringOptional
idstringOptionalformat: "objectid"
parentFolderstringOptionalformat: "objectid"

Parent folder for the asset

uploadUrlstringOptionalformat: "uri"
assetUrlstringOptionalformat: "uri"

S3 link to the asset

hostedUrlstringOptionalformat: "uri"

Represents the link to the asset

originalFileNamestringOptional

Original file name when uploaded. If not specified at time of upload, it may be extracted from the raw file name

createdOnstringOptionalformat: "date-time"

Date the asset metadata was created

lastUpdatedstringOptionalformat: "date-time"

Date the asset metadata was last updated

Errors